IDsDisplaySpecifier::GetIcon, méthode (dsclient.h)

Article
08/23/2023

La méthode IDsDisplaySpecifier::GetIcon obtient l’icône pour une classe d’objet donnée.

Syntaxe

HICON GetIcon(
  [in] LPCWSTR pszObjectClass,
  [in] DWORD   dwFlags,
  [in] INT     cxIcon,
  [in] INT     cyIcon
);

Paramètres

[in] pszObjectClass

Pointeur vers une chaîne Unicode terminée par une valeur Null qui contient le nom de la classe d’objet pour laquelle obtenir l’icône. Les exemples de nom de la classe d’objet sont « user » et « container ».

[in] dwFlags

Contient un ensemble d’indicateurs qui indiquent le type d’icône à récupérer. Il peut s’agir d’une combinaison d’une ou plusieurs des valeurs suivantes.

DSGIF_ISNORMAL

Obtient l’icône normale pour la classe d’objet.

DSGIF_ISOPEN

Obtient l’icône d’ouverture, telle qu’un dossier ouvert, pour la classe d’objet . Si la classe d’objet n’a pas d’icône ouverte, cette méthode tente d’obtenir l’icône normale pour la classe d’objet.

DSGIF_ISDISABLED

Obtient l’icône désactivée, telle qu’un utilisateur désactivé, pour la classe d’objet . Si la classe d’objet n’a pas d’icône désactivée, cette méthode tente d’obtenir l’icône normale pour la classe d’objet.

DSGIF_ISMASK

Permet de masquer les indicateurs DSGIF_ISNORMAL, DSGIF_ISOPEN et DSGIF_ISDISABLED .

DSGIF_GETDEFAULTICON

Si aucune icône n’est trouvée pour la classe d’objet, cette méthode retourne une icône par défaut. Si cet indicateur n’est pas spécifié et qu’aucune icône n’est trouvée pour la classe d’objet, cette méthode retourne NULL.

DSGIF_DEFAULTISCONTAINER

Si aucune icône n’est trouvée pour la classe d’objet, cette méthode retourne l’icône de conteneur en tant qu’icône par défaut. Si cet indicateur n’est pas spécifié et qu’aucune icône n’est trouvée pour la classe d’objet, cette méthode retourne NULL.

[in] cxIcon

Contient la largeur souhaitée, en pixels, de l’icône. Cette méthode obtient l’icône qui correspond le plus à cette largeur.

[in] cyIcon

Contient la hauteur souhaitée, en pixels, de l’icône. Cette méthode obtient l’icône qui correspond le plus à cette hauteur.

Valeur retournée

Retourne un handle à l’icône, en cas de réussite, ou NULL dans le cas contraire. L’appelant doit détruire cette icône quand elle n’est plus nécessaire en passant ce handle à DestroyIcon.

Spécifications


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	dsclient.h
DLL	Dsadmin.dll

Voir aussi

DestroyIcon

Afficher les interfaces dans services de domaine Active Directory

IDDisplaySpecifier

Partager via