Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WcsGetDefaultColorProfileSize function

Returns the size, in bytes, of the default color profile name (including the NULL terminator), for a device.

Syntax


BOOL WINAPI WcsGetDefaultColorProfileSize(
  _In_      WCS_PROFILE_MANAGEMENT_SCOPE profileManagementScope,
  _In_opt_  PCWSTR pDeviceName,
  _In_      COLORPROFILETYPE cptColorProfileType,
  _In_      COLORPROFILESUBTYPE cpstColorProfileSubType,
  _In_      DWORD dwProfileID,
  _Out_     PDWORD pcbProfileName
);

Parameters

profileManagementScope [in]

A WCS_PROFILE_MANAGEMENT_SCOPE value that specifies the scope of this profile management operation.

pDeviceName [in, optional]

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 used.

cptColorProfileType [in]

A COLORPROFILETYPE value specifying the color profile type.

cpstColorProfileSubType [in]

A COLORPROFILESUBTYPE value specifying the color profile subtype.

dwProfileID [in]

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

pcbProfileName [out]

A pointer to a location that receives the size, in bytes, of the path name of the default color profile, including the NULL terminator.

Return value

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

Use this function to return the required size of the buffer that is pointed to by the pProfileName parameter in the WcsGetDefaultColorProfile function.

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

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Icm.h

Library

Mscms.lib

DLL

Mscms.dll

See also

Basic Color Management Concepts
Windows Color System Schemas and Algorithms
Functions
COLORPROFILESUBTYPE
COLORPROFILETYPE
WCS_PROFILE_MANAGEMENT_SCOPE
WcsGetDefaultColorProfile

 

 

Community Additions

Show:
© 2015 Microsoft