Condividi tramite

Funzione OpenColorProfileA (icm.h)

  • Articolo

Crea un handle in un profilo colore specificato. L'handle può quindi essere usato in altre funzioni di gestione del profilo.

Sintassi

HPROFILE OpenColorProfileA(
  PPROFILE pProfile,
  DWORD    dwDesiredAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode
);

Parametri

pProfile

Puntatore a una struttura del profilo colore che specifica il profilo. Il puntatore pProfile può essere liberato non appena viene creato l'handle.

dwDesiredAccess

Specifica come accedere al profilo specificato. Questo parametro deve accettare uno dei valori costanti seguenti.

Valore Significato
PROFILE_READ
 Apre il profilo per l'accesso in lettura.
PROFILE_READWRITE
 Apre il profilo sia per l'accesso in lettura che in scrittura. Non ha alcun effetto per i profili XML WCS.

dwShareMode

Specifica la modalità di condivisione del profilo, se il profilo è contenuto in un file. Il valore zero impedisce che il profilo venga condiviso. Il parametro può contenere una o entrambe le costanti seguenti (combinate tramite addizione o OR logico).

Valore Significato
FILE_SHARE_READ
 È possibile eseguire altre operazioni aperte nel profilo per l'accesso in lettura.
FILE_SHARE_WRITE
 È possibile eseguire altre operazioni aperte nel profilo per l'accesso in scrittura. Non ha alcun effetto per i profili XML WCS.

dwCreationMode

Specifica le azioni da eseguire sul profilo durante l'apertura, se contenuto in un file. Questo parametro deve accettare uno dei valori costanti seguenti.

Valore Significato
CREATE_NEW
 Crea un nuovo profilo. Ha esito negativo se il profilo esiste già.
CREATE_ALWAYS
 Crea un nuovo profilo. Sovrascrive il profilo, se esistente.
OPEN_EXISTING
 Apre il profilo. Ha esito negativo se non esiste
OPEN_ALWAYS
 Apre il profilo, se esistente. Per i profili CPI, se il profilo non esiste, crea il profilo. Per i profili XML WCS, se il profilo non esiste, restituisce un errore.
TRUNCATE_EXISTING
 Apre il profilo e lo tronca a zero byte, restituendo un profilo ICC vuoto. Ha esito negativo se il profilo non esiste.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è l'handle del profilo colore aperto. Per i profili ICC e WCS, la funzione CAMP e GMMP viene fornita dalla funzione in base all'attuale CAMP e GMMP predefinito nel Registro di sistema.

Quando OpenColorProfile rileva un profilo ICC con un profilo WCS incorporato e se il membro dwType all'interno della struttura Profile non accetta il valore DONT_USE_EMBEDDED_WCS_PROFILES, deve estrarre e usare i profili WCS contenuti in questo WcsProfilesTag. L'HPROFILE restituito sarà un HPROFILE WCS.

Se questa funzione ha esito negativo, il valore restituito è NULL. Per informazioni sugli errori estesi, chiamare GetLastError.

Commenti

Se i dati del profilo non vengono specificati usando un nome file, dwShareMode e dwCreationMode vengono ignorati.

i flag dwCreationMode CREATE_NEW, CREATE_ALWAYS e TRUNCATE_EXISTING restituiranno sempre hPROFILES ICC vuoti. Se sono presenti altri flag dwCreationMode , internalOpenColorProfile viene chiamato (usando i flag forniti dall'API) per determinare se il profilo è ICC o WCS XML.

All'interno del percorso del codice CPI, viene restituito un HPROFILE DI CPI usando i flag di condivisione, accesso e creazione richiesti come specificato nelle tabelle precedenti.

All'interno del percorso WCS, il flag dwCreationMode OPEN_ALWAYS avrà esito negativo se il profilo non esiste, poiché i profili WCS non possono essere creati o modificati all'interno dell'architettura WCS (devono essere modificati al di fuori di esso, usando MSXML6). Per lo stesso motivo, il flag dwShareMode FILE_SHARE_WRITE e il flag dwDesiredAccess PROFILE_READWRITE vengono ignorati all'interno del percorso WCS.

Quando la funzione apre il profilo CPI, cerca un WcsProfilesTag e, se presente, estrae e usa i profili WCS originali contenuti. Vedere WcsCreateIccProfile.

Un HPROFILE con informazioni sul profilo WCS deriva da un DMP acquisendo il valore predefinito CAMP e il GMMP predefinito dal Registro di sistema. HPROFILE è una composizione di DMP, CAMP e GMMP.

Dopo aver creato l'handle per il profilo colore, è possibile eliminare tutte le informazioni usate per creare tale handle.

Utilizzare la funzione CloseColorProfile per chiudere un handle di oggetto restituito da OpenColorProfile.

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