Fonction SetStandardColorSpaceProfileW (icm.h)

Article
08/24/2023

Inscrit un profil spécifié pour un espace de couleurs standard donné. Le profil peut être interrogé à l’aide de GetStandardColorSpaceProfileW.

Syntaxe

BOOL SetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwProfileID,
  PCWSTR pProfileName
);

Paramètres

pMachineName

Réservé. Doit avoir la valeur NULL. Ce paramètre est destiné à pointer vers le nom de l’ordinateur sur lequel définir un profil d’espace de couleurs standard. Un pointeur NULL indique l’ordinateur local.

dwProfileID

Spécifie la valeur d’ID de l’espace de couleurs standard que représente le profil donné. Il s’agit d’une valeur d’ID personnalisée utilisée pour identifier de manière unique le profil d’espace de couleurs au sein de votre application.

pProfileName

Pointe vers un chemin complet vers le fichier de profil.

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

Le profil doit déjà être installé sur le système avant de pouvoir être inscrit pour un espace de couleurs standard.

Cette fonction prend en charge les profils de modèle d’appareil (DPM) windows Color System (WCS) en plus des profils ICC (International Color Consortium). Il ne prend pas en charge les profils WCS CAMP ou GMMP et retourne une erreur si ces profils sont utilisés.

Prise en charge par utilisateur/LUA

Cela inscrit un profil spécifié pour un espace de couleur standard donné uniquement pour l’utilisateur actuel.

Cela utilise WcsSetDefaultColorProfile avec WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.

Il s’agit d’un fichier exécutable dans le contexte LUA si le profil est déjà installé. Sinon, l’accès est refusé, car l’installation est à l’échelle du système et nécessite des privilèges d’administrateur.

Spécifications


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