WcsGetDefaultColorProfile function

The WcsGetDefaultColorProfile function retrieves the default color profile for a device, or the device-independent default if the device is not specified.

Syntax

BOOL WcsGetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  DWORD                        cbProfileName,
  LPWSTR                       pProfileName
);

Parameters

scope

TBD

pDeviceName

A pointer to the name of the device for which the default color profile is to be obtained. If NULL, a device-independent default profile will be obtained.

cptColorProfileType

A COLORPROFILETYPE value that specifies the color profile type.

cpstColorProfileSubType

A COLORPROFILESUBTYPE value that specifies the color profile subtype.

dwProfileID

The ID of the color space that the color profile represents.

cbProfileName

The buffer size, in bytes, of the buffer pointed to by pProfileName.

pProfileName

A pointer to a buffer to receive the name of the color profile.

Return Value

None

Remarks

Use the WcsGetDefaultColorProfileSize function to obtain the required size of the buffer pointed to by the pProfileName parameter.

If WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, the current user setting, is present, it overrides the system-wide default for profileManagementScope.

This function is executable in Least-Privileged User Account (LUA) context.

Requirements

   
Windows version Included in Windows Vista and later.
Target Platform Universal
Header icm.h
Library Mscms.lib
DLL Mscms.dll

See Also

COLORPROFILESUBTYPE

COLORPROFILETYPE

WCS_PROFILE_MANAGEMENT_SCOPE

WcsGetDefaultColorProfileSize