Partager via

WcsEnumColorProfiles, fonction (icm.h)

  • Article

Énumère les profils de couleur associés à n’importe quel appareil, dans l’étendue spécifiée.

Notes

Cette API ne prend pas en charge les profils de couleur avancés pour les moniteurs HDR. Utilisez ColorProfileGetDisplayList pour gérer les profils de couleurs avancés.

Syntaxe

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

Paramètres

scope

Valeur WCS_PROFILE_MANAGEMENT_SCOPE spécifiant l’étendue de cette opération de gestion de profil.

pEnumRecord

Pointeur vers une structure spécifiant les critères d’énumération.

pBuffer

Pointeur vers une mémoire tampon dans laquelle les noms de profil doivent être énumérés. La fonction WcsEnumColorProfiles place, dans cette mémoire tampon, une chaîne MULTI_SZ qui se compose de noms de profil qui répondent aux critères spécifiés dans *pEnumRecord.

dwSize

Variable qui contient la taille, en octets, de la mémoire tampon pointée par pBuffer. Consultez Remarques.

pnProfiles

Pointeur facultatif vers une variable qui reçoit le nombre de noms de profil copiés dans la mémoire tampon vers laquelle pBuffer pointe. Peut avoir la valeur NULL si ces informations ne sont pas nécessaires.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Notes

Utilisez la fonction WcsEnumColorProfilesSize pour récupérer la valeur du paramètre dwSize , qui est la taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre pBuffer .

Si le paramètre profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, seules les associations de profils à l’échelle du système à l’appareil sont prises en compte. Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, seules les associations par utilisateur pour l’utilisateur actuel sont prises en compte. Si WcsSetUsePerUserProfiles n’a jamais été appelé pour cet utilisateur, ou si WcsSetUsePerUserProfiles a été récemment appelé pour cet utilisateur avec son paramètre usePerUserProfiles défini sur FALSE, WCSEnumColorProfiles retourne une liste vide.

Si WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (le paramètre utilisateur actuel) est présent, il remplace la valeur par défaut à l’échelle du système pour le paramètre profileManagementScope .

Cette fonction est exécutable dans Least-Privileged contexte de compte d’utilisateur (LUA).

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête icm.h
Bibliothèque Mscms.lib
DLL Mscms.dll

Voir aussi