GetColorDirectoryA, fonction (icm.h)

Article
03/11/2023

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	Mechanism
Énumération de tous les profils installés	Utiliser WcsEnumColorProfilesSize et WcsEnumColorProfiles, ou EnumColorProfilesA
Installation/désinstallation des profils de couleur	Utiliser InstallColorProfileA/UninstallColorProfileA
Ouverture directe d’un fichier de profil de couleur	Utilisez OpenColorProfileA avec dwType=PROFILE_FILENAME dans le paramètre de struct PROFILE. Ou utilisez WcsOpenColorProfileA. 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 GetColorDirectoryA(
  PCSTR  pMachineName,
  PSTR   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


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