Funzione WcsEnumColorProfiles (icm.h)

  • Articolo

Enumera i profili di colore associati a qualsiasi dispositivo, nell'ambito specificato.

Nota

Questa API non supporta i profili "colore avanzati" per i monitor HDR. Usare ColorProfileGetDisplayList per la gestione di profili di colore avanzati.

Sintassi

BOOL WcsEnumColorProfiles(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PENUMTYPEW                   pEnumRecord,
  PBYTE                        pBuffer,
  DWORD                        dwSize,
  PDWORD                       pnProfiles
);

Parametri

scope

Valore WCS_PROFILE_MANAGEMENT_SCOPE che specifica l'ambito di questa operazione di gestione del profilo.

pEnumRecord

Puntatore a una struttura che specifica i criteri di enumerazione.

pBuffer

Puntatore a un buffer in cui devono essere enumerati i nomi dei profili. La funzione WcsEnumColorProfiles posiziona, in questo buffer, una stringa MULTI_SZ costituita da nomi di profilo che soddisfano i criteri specificati in *pEnumRecord.

dwSize

Variabile che contiene le dimensioni, in byte, del buffer a cui punta pBuffer. Vedere Osservazioni.

pnProfiles

Puntatore facoltativo a una variabile che riceve il numero di nomi di profilo copiati nel buffer a cui punta pBuffer . Può essere NULL se queste informazioni non sono 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

Utilizzare la funzione WcsEnumColorProfilesSize per recuperare il valore per il parametro dwSize , ovvero le dimensioni, in byte, del buffer a cui punta il parametro pBuffer .

Se il parametro profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, vengono considerate solo associazioni a livello di sistema dei profili al dispositivo. Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, vengono considerate solo associazioni per utente per utente corrente. Se WcsSetUsePerUserProfiles non è mai stato chiamato per questo utente o se WcsSetUsePerUserProfiles è stato chiamato più di recente per questo utente con il relativo parametro usePerUserProfiles impostato su FALSE, WCSEnumColorProfiles restituisce un elenco vuoto.

Se WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (impostazione utente corrente) è presente, esegue l'override del valore predefinito a livello di sistema per il parametro profileManagementScope .

Questa funzione è eseguibile nel contesto Least-Privileged account utente (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

Vedi anche