GetICMProfile

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.

See Also

SetICMProfile