Funzione DisassociateColorProfileFromDeviceA (icm.h)
Annulla l'associazione di un profilo colore specificato con un dispositivo specificato in un computer specificato.
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 DisassociateColorProfileFromDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR pDeviceName
);
Parametri
pMachineName
Riservato. Deve essere NULL. Questo parametro punta al nome del computer in cui annullare l'associazione del profilo e del dispositivo specificati. Un puntatore NULL indica il computer locale.
pProfileName
Puntatore al nome file del profilo per annullare l'associazione.
pDeviceName
Puntatore al nome del dispositivo per annullare l'associazione.
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
Se più di un profilo è associato a un dispositivo, WCS usa l'ultimo profilo 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 (che è l'impostazione predefinita in questo esempio), il WCS userà 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.
DisassociateColorProfileFromDevice rimuove sempre il profilo specificato dall'elenco di associazione dei profili per utente corrente 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 associazioni di profili per utente per il dispositivo. In tal caso, DisassociateColorProfileFromDevice rimuove semplicemente il profilo specificato dall'elenco di associazione dei profili per utente esistente per il dispositivo. In caso contrario, DisassociateColorProfileFromDevice crea un nuovo elenco di associazioni per profilo utente per il dispositivo copiando l'elenco di associazioni a livello di sistema per tale dispositivo. Rimuove quindi il profilo specificato dall'elenco per utente. Da questo punto in poi, l'utente corrente userà un elenco di associazioni per profilo utente per il dispositivo specificato, come se WcsSetUsePerUserProfiles fosse stato chiamato per pDevice con il parametro usePerUserProfiles impostato su TRUE.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |