SetStandardColorSpaceProfile

[This is preliminary documentation and subject to change.]

The SetStandardColorSpaceProfile function registers a specified profile for a given standard color space. The profile can be queried using GetStandardColorSpaceProfile.

BOOL WINAPI SetStandardColorSpaceProfile(
  PCTSTR pMachineName,
  DWORD dwProfileID,
  PCSTR pProfilename
);
 

Parameters

pMachineName

Reserved for future use; must be NULL. This parameter is intended to point to the name of the machine on which to set a standard color space profile. A NULL pointer indicates the local machine.

dwProfileID

Specifies the ID value of the standard color space that the given profile represents.

pProfilename

Points to a fully qualified path to the profile file.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. For extended error information, call GetLastError.

Remarks

The profile must already be installed on the system before it can be registered for a standard color space.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Color Management Overview, ICM 2.0 Functions, GetStandardColorSpaceProfile