Funzione AssociateColorProfileWithDeviceW (icm.h)

  • Articolo

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

Vedi anche