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

Article
03/02/2024

La méthode IDsDisplaySpecifier ::GetIconLocation obtient l’emplacement de l’icône pour une classe d’objet donnée. L’emplacement de l’icône inclut le nom de fichier et l’identificateur de ressource.

Syntaxe

HRESULT GetIconLocation(
  [in]      LPCWSTR pszObjectClass,
  [in]      DWORD   dwFlags,
  [in, out] LPWSTR  pszBuffer,
  [in]      INT     cchBuffer,
  [in, out] INT     *presid
);

Paramètres

[in] pszObjectClass

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le nom de la classe d’objet pour laquelle obtenir l’emplacement de 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’un ou plusieurs des éléments suivants.

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_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, out] pszBuffer

Pointeur vers une mémoire tampon de caractères large qui reçoit le chemin d’accès et le nom de fichier du fichier qui contient l’icône. Cette mémoire tampon doit comporter au moins des caractères larges cchBuffer .

[in] cchBuffer

Contient la taille de la mémoire tampon pszBuffer , en caractères larges, y compris le caractère NULL de fin. Si le nom de fichier dépasse ce nombre de caractères, le nom de fichier est tronqué.

[in, out] presid

Pointeur vers une valeur INT qui reçoit l’identificateur de ressource ou l’index de l’icône. Si cette valeur est positive, la valeur est l’index de l’icône dans le fichier. Si cette valeur est négative, la valeur absolue de cette valeur est l’identificateur de ressource de l’icône dans le fichier.

Valeur retournée

Retourne une valeur HRESULT standard, y compris les éléments suivants.

Configuration requise

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

Afficher les interfaces dans services de domaine Active Directory

IDDisplaySpecifier

IDsDisplaySpecifier ::GetIcon

Partager via