Función DisassociateColorProfileFromDeviceW (icm.h)

  • Artículo

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

Nota:

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

Sintaxis

BOOL DisassociateColorProfileFromDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR pDeviceName
);

Parámetros

pMachineName

Reservado. Debe ser NULL. Este parámetro está pensado para apuntar al nombre del equipo en el que se va a desasociar el perfil y el dispositivo especificados. Un puntero NULL indica el equipo local.

pProfileName

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

pDeviceName

Puntero al nombre del dispositivo que se va a desasociar.

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

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

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

DisassociateColorProfileFromDevice siempre quita el perfil especificado de la lista de asociaciones de perfil por usuario del usuario actual para el dispositivo especificado. Antes de quitar el perfil de la lista, DisassociateColorProfileFromDevice determina si el usuario ha expresado previamente el deseo de usar una lista de asociaciones de perfil por usuario para el dispositivo. Si es así, DisassociateColorProfileFromDevice simplemente quita el perfil especificado de la lista de asociaciones de perfil por usuario existente para el dispositivo. Si no es así, DisassociateColorProfileFromDevice crea una nueva lista de asociaciones de perfil por usuario para el dispositivo copiando la lista de asociaciones de todo el sistema para ese dispositivo. A continuación, quita el perfil especificado de la lista por usuario. A partir de ese momento, el usuario actual usará una lista de asociaciones de perfil por usuario para el dispositivo especificado, como si se hubiera llamado a WcsSetUsePerUserProfiles para pDevice con el parámetro usePerUserProfiles establecido en TRUE.

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