Share via


IsColorProfileValid

The IsColorProfileValid function allows an application to determine whether the specified profile is a valid International Color Consortium (ICC) profile or a valid Windows Color System (WCS) profile handle that can be used for color management. WCS profile validation does not invoke the underlying device models, but instead simply validates against the XML schema and the schema element range limits.

BOOL WINAPI IsColorProfileValid(
  HPROFILE hProfile,  PBOOL pbValid);

Parameters

  • hProfile
    Specifies a handle to the profile to be validated. The function determines whether the HPROFILE contains ICC or WCS profile information.
  • pbValid
    Pointer to a variable that is set to TRUE on return if the operation succeeds and the profile is a valid ICC or WCS profile. If the operation fails or the profile is not valid the variable is FALSE.

Return Values

If this function succeeds and the profile is valid, the return value is TRUE.

If this function fails (or succeeds and the profile is not valid), the return value is FALSE. For extended error information, call GetLastError.

Requirements

**  Windows Vista:** Support for WCS profiles included in Windows Vista and later.
**  Windows NT/2000/XP:** Support for ICC profiles included in Windows 2000 and later.
**  Windows 95/98/Me:** Support for ICC profiles included in Windows 98 and later.
**  Header:** Declared in Icm.h.
**  Library:** Use Mscms.lib.

See Also

Basic Color Management Concepts, Functions