Funzione DisassociateColorProfileFromDeviceW (icm.h)
Annulla l'accesso a un profilo di colore specificato con un dispositivo specificato in un computer specificato.
Nota
Questa API non supporta i profili "colore avanzati" per i monitor HDR. Usare ColorProfileRemoveDisplayAssociation per la gestione di profili di colore avanzati.
Sintassi
BOOL DisassociateColorProfileFromDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Parametri
pMachineName
Riservato. Deve essere NULL. Questo parametro è destinato a puntare al nome del computer in cui disassociare il profilo e il dispositivo specificati. Un puntatore NULL indica il computer locale.
pProfileName
Puntatore al nome del file del profilo da annullare.
pDeviceName
Puntatore al nome del dispositivo da annullare.
Valore restituito
Se questa funzione ha esito positivo, il valore restituito è TRUE.
Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.
Commenti
Se più di un profilo è associato a un dispositivo, WCS usa l'ultimo associato come impostazione predefinita. Ovvero, se l'applicazione associa in sequenza tre profili a un dispositivo, WCS userà l'ultimo associato come impostazione predefinita. Se l'applicazione chiama quindi la funzione DisassociateColorProfileFromDevice per annullare l'associazione del terzo profilo (ovvero l'impostazione predefinita in questo esempio), il WCS userà il secondo profilo come impostazione predefinita.
Se l'applicazione annulla l'accesso a tutti i profili da un dispositivo, WCS usa il profilo sRGB come impostazione predefinita.
DisassociateColorProfileFromDevice rimuove sempre il profilo specificato dall'elenco di associazione del profilo utente corrente per utente per il dispositivo specificato. Prima di rimuovere il profilo dall'elenco, DisassociateColorProfileFromDevice determina se l'utente ha espresso in precedenza il desiderio di usare un elenco di associazione per profilo utente per il dispositivo. In tal caso, DisassociateColorProfileFromDevice rimuove semplicemente il profilo specificato dall'elenco di associazione per profilo utente esistente per il dispositivo. In caso contrario, DisassociateColorProfileFromDevice crea un nuovo elenco di associazione per profilo utente per il dispositivo copiando l'elenco di associazione a livello di sistema per tale dispositivo. Rimuove quindi il profilo specificato dall'elenco utenti. A partire da questo punto, l'utente corrente userà un elenco di associazione per profilo utente per il dispositivo specificato, come se WcsSetUsePerUserProfiles fosse stato chiamato per pDevice con il parametro usePerUserProfiles impostato su TRUE.
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 |