Funzione AssociateColorProfileWithDeviceW (icm.h)
Associa un profilo colore specificato a un dispositivo specificato.
Nota
Questa API non supporta i profili di colore avanzati per i monitor HDR. Usare ColorProfileAddDisplayAssociation per la gestione di profili colori avanzati.
Sintassi
BOOL AssociateColorProfileWithDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Parametri
pMachineName
Riservato. Deve essere NULL. Questo parametro deve puntare al nome del computer in cui associare il profilo e il dispositivo specificati. Un puntatore NULL indica il computer locale.
pProfileName
Punta al nome file del profilo da associare.
pDeviceName
Punta al nome del dispositivo da associare.
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
La funzione AssociateColorProfileWithDevice avrà esito negativo se il profilo non è stato installato nel computer usando la funzione InstallColorProfileW .
Si noti che in Windows (Windows 95 o versione successiva) il driver di dispositivo PostScript per le stampanti presuppone un modello di colore CMYK. Pertanto, tutte le stampanti PostScript devono usare un profilo colore CMYK. Windows 2000 non presenta questa limitazione.
Se il dispositivo specificato è un monitoraggio, questa funzione aggiorna il profilo predefinito.
Diversi profili sono in genere associati alle stampanti, in base ai tipi di carta e inchiostro. Non prevede alcun valore predefinito. L'interfaccia GDI seleziona quella migliore dai profili associati quando l'applicazione crea un contesto di dispositivo.The GDI select the best one from the associated profiles when your application create a device context (DC).
Gli scanner non hanno anche un profilo predefinito. Tuttavia, è atipico associare più profili a uno scanner.
AssociateColorProfileWithDevice aggiunge sempre il profilo specificato all'elenco di associazione dei profili per utente corrente per il dispositivo specificato. Prima di aggiungere il profilo all'elenco, AssociateColorProfileWithDevice 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, AssociateColorProfileWithDevice aggiunge semplicemente il profilo specificato all'elenco di associazione dei profili per utente esistente per il dispositivo. In caso contrario, AssociateColorProfileWithDevice crea un nuovo elenco di associazioni di profili per utente per il dispositivo copiando l'elenco di associazioni a livello di sistema per tale dispositivo. Aggiunge quindi il profilo specificato all'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
| 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 |