Condividi tramite


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

Vedi anche