Compartir a través de

Función WcsAssociateColorProfileWithDevice (icm.h)

  • Artículo

Asocia un perfil de color WCS especificado a un dispositivo especificado.

Nota:

Esta API no admite perfiles de "color avanzado" para monitores HDR. Use ColorProfileAddDisplayAssociation para administrar perfiles de color avanzados.

Sintaxis

BOOL WcsAssociateColorProfileWithDevice(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pProfileName,
  PCWSTR                       pDeviceName
);

Parámetros

scope

Valor WCS_PROFILE_MANAGEMENT_SCOPE que especifica el ámbito de esta operación de administración de perfiles, que podría ser para todo el sistema o para el usuario actual.

pProfileName

Puntero al nombre de archivo del perfil que se va a asociar.

pDeviceName

Puntero al nombre del dispositivo con el que se va a asociar el perfil.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Se produce un error en la función WCSAssociateColorProfileWithDevice si el perfil no se ha instalado en el equipo mediante la función InstallColorProfileW .

Si el parámetro profileManagementScope es WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, la asociación de perfiles es para todo el sistema y se aplica a todos los usuarios. Si profileManagementScope es WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, la asociación solo es para el usuario actual.

Esta función es ejecutable en Least-Privileged contexto de cuenta de usuario (LUA) si profileManagementScope está WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER. De lo contrario, se requieren privilegios administrativos.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado icm.h
Library Mscms.lib
Archivo DLL Mscms.dll

Consulte también