GetICMProfile

Overview

Group

Quick Info

Windows NT
No
Win95
Yes
Win32s
No
Import Library
gdi32.lib
Header File
wingdi.h
Unicode
WinNT
Platform Notes
None

The GetICMProfile function retrieves the name of the color profile file for the device associated with the specified device context.

BOOL GetICMProfile(

HDC hdc,
LPDWORD lpcbName,
LPTSTR lpszFilename
);

Parameters
hdc

Handle to the device context.

lpcbName

Pointer to a DWORD that contains the size, in bytes or characters, of the buffer that receives the filename, depending on whether the ANSI or Unicode version of the function is used.

If the buffer is too small, the function fails, and sets the DWORD pointed to by lpcbName to the minimum required buffer size.

lpszFilename

Pointer to the buffer that receives the null-terminated string specifying the full path of the color profile file.

Return Values
If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks
The function obtains the image color matching profile for the device context regardless of whether image color matching (ICM) is enabled for the device context specified by hdc.