Compartir a través de

Función WcsDisassociateColorProfileFromDevice (icm.h)

  • Artículo

Desasocia un perfil de color WCS especificado de un dispositivo especificado en un equipo.

Nota:

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

Sintaxis

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

Parámetros

scope

Valor de 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 desasociar.

pDeviceName

Puntero al nombre del dispositivo del que se va a desasociar 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 debe instalar el perfil de color de WCS. Además, debe usar el mismo valor profileManagementScope que cuando el dispositivo estaba asociado al perfil. Consulte WcsAssociateColorProfileWithDevice.

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

Si hay más de un perfil de color asociado a un dispositivo, WCS usa el último perfil asociado como valor predeterminado. Por ejemplo, si la aplicación asocia secuencialmente tres perfiles a un dispositivo, WCS usa el último perfil asociado como valor predeterminado. Si la aplicación llama a la función WcsDisassociateColorProfileFromDevice para desasociar el tercer perfil (que es el valor predeterminado en este ejemplo), WCS usa el segundo perfil como predeterminado.

Si la aplicación desasocia todos los perfiles de un dispositivo, WCS usa el perfil sRGB como valor predeterminado.

Si profileManagementScope es WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, esta función es ejecutable en Least-Privileged contexto de cuenta de usuario (LUA). 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