Funzione SetStandardColorSpaceProfileA (icm.h)
Registra un profilo specificato per uno spazio colore standard specificato. Il profilo può essere sottoposto a query tramite GetStandardColorSpaceProfileW.
Sintassi
BOOL SetStandardColorSpaceProfileA(
PCSTR pMachineName,
DWORD dwProfileID,
PCSTR pProfilename
);
Parametri
pMachineName
Riservato. Deve essere NULL. Questo parametro è destinato a puntare al nome del computer in cui impostare un profilo di spazio colore standard. Un puntatore NULL indica il computer locale.
dwProfileID
Specifica il valore ID dello spazio colore standard rappresentato dal profilo specificato. Si tratta di un valore ID personalizzato usato per identificare in modo univoco il profilo dello spazio dei colori all'interno dell'applicazione.
pProfilename
Punta a un percorso completo del file di profilo.
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
Il profilo deve essere già installato nel sistema prima di poter essere registrato per uno spazio colore standard.
Questa funzione supporta i profili del modello di dispositivo Windows Color System (WCS) oltre ai profili International Color Consortium (ICC). Non supporta i profili WCS CAMP o GMMP e restituirà un errore se tali profili vengono usati.
Supporto per utente/LUA
Verrà registrato un profilo specificato solo per un determinato spazio colore standard per l'utente corrente.
In questo modo viene usato WcsSetDefaultColorProfile con WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.
Questo è eseguibile nel contesto LUA se il profilo è già installato, non riesce altrimenti con l'accesso negato perché l'installazione è a livello di sistema e richiede privilegi di amministratore.
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 |