Condividi tramite

Funzione UpdateICMRegKeyW (wingdi.h)

  • Articolo

(obsoleto; conservato per la compatibilità con le versioni precedenti)

La funzione UpdateICMRegKey gestisce i profili colore e i moduli di gestione dei colori nel sistema.

Sintassi

BOOL UpdateICMRegKeyW(
  DWORD  reserved,
  LPWSTR lpszCMID,
  LPWSTR lpszFileName,
  UINT   command
);

Parametri

reserved

Riservato, deve essere impostato su zero.

lpszCMID

Punta a una stringa che specifica l'identificatore del profilo ICC per la DLL di gestione dei colori da usare con il profilo.

lpszFileName

Punta a un nome di file di profilo colori ICC completo o a una struttura DEVMODE.

command

Specifica una funzione da eseguire. Può avere uno dei valori seguenti.

 

Valore Significato
ICM_ADDPROFILE
 Installa il profilo ICC nel sistema.
ICM_DELETEPROFILE
 Disinstalla il profilo ICC dal sistema, ma non elimina il file.
ICM_QUERYPROFILE
 Determina se il profilo è già installato nel sistema.
ICM_SETDEFAULTPROFILE
 Rende il profilo primo tra gli uguali.
ICM_REGISTERICMATCHER
 Registra un CMM nel sistema. Il parametro pszFileName punta a un percorso completo per la DLL CMM. Il parametro lpszCMID punta a un DWORD che identifica LMM.
ICM_UNREGISTERICMATCHER
 Annulla la registrazione di CMM dal sistema. Il parametro lpszCMID punta a un DWORD che identifica LMM.
ICM_QUERYMATCH
 Determina se esiste un profilo basato sulla struttura DEVMODE a cui punta il parametro pszFileName.

Valore restituito

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

Se questa funzione ha esito negativo, il valore restituito è FALSE.

Osservazioni

Non tutti i parametri vengono usati da tutte le funzioni. Il parametro nCommand specifica la funzione da eseguire.

Questa funzione viene mantenuta per la compatibilità con le versioni precedenti e può essere rimossa nelle versioni future di ICM.

Windows 95/98/Me: UpdateICMRegKeyW è supportato dal livello Microsoft per Unicode. Per usarlo, è necessario aggiungere determinati file all'applicazione, come descritto in Livello Microsoft per Unicode in Windows 95/98/Me Systems.

Nota

L'intestazione wingdi.h definisce UpdateICMRegKey come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione wingdi.h
libreria Gdi32.lib
dll Gdi32.dll

Vedere anche