GetStandardColorSpaceProfileW 函数 (icm.h)

  • 项目

检索为指定标准 颜色空间注册的颜色配置文件。

语法

BOOL GetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwSCS,
  PWSTR  pBuffer,
  PDWORD pcbSize
);

parameters

pMachineName

保留。 必须为 NULL。 此参数旨在指向要获取标准颜色空间配置文件的计算机的名称。 NULL 指针指示本地计算机。

dwSCS

指定要检索配置文件的标准颜色空间的 ID 值。 此参数的唯一有效值是LCS_sRGB和LCS_WINDOWS_COLOR_SPACE。

pBuffer

指向要在其中放置配置文件名称的缓冲区的指针。 如果 为 NULL，则调用将返回 TRUE ，并且所需的缓冲区大小将放置在 pdwSize 中。

pcbSize

指向变量的指针，该变量包含 pProfileName 指向的缓冲区的大小（以字节为单位）。 返回时，变量包含实际使用或所需的缓冲区的大小。

返回值

如果此函数成功，则返回值为 TRUE。

如果此函数失败，则返回值为 FALSE。 有关扩展的错误信息，请调用 GetLastError。

注解

如果应用程序要动态分配 pProfileName 指向的缓冲区，则应用程序可以调用 GetStandardColorSpaceProfile 函数来检索缓冲区所需的大小。 如果调用 GetStandardColorSpaceProfile 且 pProfileName 设置为 NULL，它将返回 FALSE，并且 pdwSize 指向的 DWORD 将包含 pProfileName 指向的缓冲区所需的字节数。 然后，应用程序可以分配缓冲区，并再次调用 GetStandardColorSpaceProfile， 并将 pProfileName 设置为缓冲区的地址。

除了国际颜色联盟 (ICC) 配置文件 (外，此函数还支持 Windows 颜色系统 (WCS) 设备模型配置文件) DMP。 它不支持 WCS CAMP 或 GMMP 配置文件，如果使用此类配置文件，将返回错误。

Windows Vista 特定功能概述

除了 ICC 配置文件之外，这还将支持 WCS DMP。 它将不支持 WCS CAMP 或 GMMP 配置文件，并且如果此类配置文件用于此 API，则会返回错误。

每用户/LUA 支持

这将检索为当前用户的给定标准颜色空间注册的颜色配置文件。 如果当前用户没有此类设置，它将检索系统范围的设置。

这使用 WcsGetDefaultColorProfile 和 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER。

这是 LUA 上下文中的可执行文件。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h
Library Mscms.lib
DLL Mscms.dll

另请参阅