Funzione WcsDisassociateColorProfileFromDevice (icm.h)

  • Articolo

Annulla l'associazione di un profilo di colore WCS specificato da un dispositivo specificato in un computer.

Nota

Questa API non supporta i profili di colore avanzati per i monitor HDR. Usare ColorProfileRemoveDisplayAssociation per la gestione di profili colori avanzati.

Sintassi

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

Parametri

scope

Valore WCS_PROFILE_MANAGEMENT_SCOPE che specifica l'ambito di questa operazione di gestione del profilo, che può essere a livello di sistema o per l'utente corrente.

pProfileName

Puntatore al nome file del profilo da annullare.

pDeviceName

Puntatore al nome del dispositivo da cui annullare l'associazione del profilo.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE.

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sugli errori estesi, chiamare GetLastError.

Commenti

È necessario installare il profilo colore WCS. Inoltre, è necessario usare lo stesso valore profileManagementScope di quando il dispositivo è stato associato al profilo. Vedere WcsAssociateColorProfileWithDevice.

Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, la disassociazione del profilo è a livello di sistema e si applica a tutti gli utenti. Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, la disassociazione è solo per l'utente corrente.

Se a un dispositivo è associato più profili di colore, WCS usa l'ultimo profilo associato come impostazione predefinita. Ad esempio, se l'applicazione associa in sequenza tre profili a un dispositivo, WCS usa l'ultimo profilo associato come impostazione predefinita. Se l'applicazione chiama quindi la funzione WcsDisassociateColorProfileFromDevice per annullare l'associazione del terzo profilo (che è l'impostazione predefinita in questo esempio), WCS usa il secondo profilo come predefinito.

Se l'applicazione annulla l'associazione di tutti i profili da un dispositivo, WCS usa il profilo sRGB come predefinito.

Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, questa funzione è eseguibile nel contesto Least-Privileged account utente (LUA). In caso contrario, sono necessari privilegi amministrativi.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h
Libreria Mscms.lib
DLL Mscms.dll

Vedi anche