Funzione GetColorDirectoryA (icm.h)
Nota
Questa API potrebbe non essere disponibile nelle versioni future. Si consiglia al software nuovo ed esistente di usare altre API per le interazioni con i profili di colore. Per alcuni esempi, vedere la tabella seguente.
| Scenario | Mechanism |
|---|---|
| Enumerazione di tutti i profili installati | Usare WcsEnumColorProfilesSize e WcsEnumColorProfiles o EnumColorProfilesA |
| Installazione/disinstallazione dei profili colore | Usare InstallColorProfileA/UninstallColorProfileA |
| Apertura diretta di un file di profilo colore | Usare OpenColorProfileA con dwType=PROFILE_FILENAME nel parametro struct PROFILE. In alternativa, usare WcsOpenColorProfileA. Icm.h contiene molte API che accettano l'HPROFILE restituito per la manipolazione del profilo di colore |
Recupera il percorso della directory COLOR di Windows in un computer specificato.
Sintassi
BOOL GetColorDirectoryA(
PCSTR pMachineName,
PSTR pBuffer,
PDWORD pdwSize
);
Parametri
pMachineName
Riservati; deve essere NULL. Questo parametro deve puntare al nome del computer in cui deve essere installato 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 punta 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 sugli errori estesi, chiamare GetLastError.
Commenti
Supporto per utente/LUA
La directory dei colori è ancora a livello di sistema. Questa funzione è eseguibile nel contesto LUA.
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 |