Condividi tramite

Funzione GetColorDirectoryW (icm.h)

  • Articolo

Nota

Questa API potrebbe non essere disponibile nelle versioni future. È consigliabile usare altre API per le interazioni del profilo di colore e nuove e esistenti. Per alcuni esempi, vedere la tabella seguente.

Scenario Mechanism
Enumerazione di tutti i profili installati Usare WcsEnumColorProfilesSize e WcsEnumColorProfiles o EnumColorProfilesW
Installazione/disinstallazione dei profili di colore Usare InstallColorProfileW/UninstallColorProfileW
Apertura diretta di un file del profilo di colore Usare OpenColorProfileW con dwType=PROFILE_FILENAME nel parametro struct PROFILE.
In alternativa, usare WcsOpenColorProfileW. Icm.h contiene molte API che accettano HPROFILE restituito per la manipolazione del profilo di colore

Recupera il percorso della directory Color di Windows in un computer specificato.

Sintassi

BOOL GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  pBuffer,
  PDWORD pdwSize
);

Parametri

pMachineName

Riservati; deve essere NULL. Questo parametro è destinato a puntare al nome del computer in cui è necessario installare il profilo. Un puntatore NULL indica il computer locale.

pBuffer

Punta al buffer in cui deve essere posizionato il percorso della directory dei colori.

pdwSize

Punta a una variabile contenente le dimensioni in byte del buffer a cui fa riferimento pBuffer. In caso di restituzione, la variabile contiene le dimensioni del buffer effettivamente usate o necessarie.

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

Supporto per utente/LUA

La directory dei colori è ancora a livello di sistema. Questa funzione è eseguibile nel contesto LUA.

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

Vedi anche