GetColorDirectoryW, fonction (icm.h)

Article
02/29/2024

Notes

Cette API peut ne pas être disponible dans les versions ultérieures. Nous encourageons les logiciels nouveaux et existants à utiliser d’autres API pour les interactions de profil de couleur. Reportez-vous au tableau ci-dessous pour obtenir quelques exemples.

Scénario	Mécanisme
Énumération de tous les profils installés	Utiliser WcsEnumColorProfilesSize et WcsEnumColorProfiles, ou EnumColorProfilesW
Installation/désinstallation des profils de couleur	Utiliser InstallColorProfileW/UninstallColorProfileW
Ouverture directe d’un fichier de profil de couleur	Utilisez OpenColorProfileW avec dwType=PROFILE_FILENAME dans le paramètre de struct PROFILE. Ou utilisez WcsOpenColorProfileW. Icm.h contient de nombreuses API qui acceptent le fichier HPROFILE retourné pour la manipulation du profil de couleur

Récupère le chemin d’accès du répertoire Windows COLOR sur un ordinateur spécifié.

Syntaxe

BOOL GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  pBuffer,
  PDWORD pdwSize
);

Paramètres

pMachineName

Réservés au; doit être NULL. Ce paramètre est destiné à pointer vers le nom de l’ordinateur sur lequel le profil doit être installé. Un pointeur NULL indique l’ordinateur local.

pBuffer

Pointe vers la mémoire tampon dans laquelle le chemin du répertoire de couleurs doit être placé.

pdwSize

Pointe vers une variable contenant la taille en octets de la mémoire tampon pointée par pBuffer. Au retour, la variable contient la taille de la mémoire tampon réellement utilisée ou nécessaire.

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.

Remarques

Prise en charge par utilisateur/LUA

Le répertoire de couleurs est toujours à l’échelle du système. Cette fonction est exécutable dans le contexte LUA.

Configuration requise

Condition requise	Valeur
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

Partager via