GetColorDirectoryA, fonction (icm.h)
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 |