Méthode IAzObjectPicker ::GetPrincipals (azroles.h)

Article
03/04/2024

La méthode GetPrincipals affiche une boîte de dialogue à partir de laquelle les utilisateurs peuvent choisir un ou plusieurs principaux, puis retourne la liste choisie des principaux et leurs identificateurs de sécurité (SID) correspondants.

Syntaxe

HRESULT GetPrincipals(
  [in]  HWND    hParentWnd,
  [in]  BSTR    bstrTitle,
  [out] VARIANT *pvSidTypes,
  [out] VARIANT *pvNames,
  [out] VARIANT *pvSids
);

Paramètres

[in] hParentWnd

Handle de la fenêtre parente de la boîte de dialogue.

[in] bstrTitle

Titre d’affichage de la boîte de dialogue.

[out] pvSidTypes

Pointeur vers un tableau d’éléments de l’SID_NAME_USE énumération qui spécifient les types de SID qui correspondent aux principaux choisis par l’utilisateur.

Il s’agit d’une variante qui contient un objet SAFEARRAY ou JScript Array . Chaque élément du tableau contient une valeur VT_I4 qui spécifie un élément de l’énumération SID_NAME_USE .

[out] pvNames

Pointeur vers un tableau de noms d’affichage des principaux choisis par l’utilisateur.

Il s’agit d’une variante qui contient un objet SAFEARRAY ou JScript Array . Chaque élément du tableau contient un VT_BSTR qui contient un nom d’affichage.

[out] pvSids

Pointeur vers un tableau de représentations sous forme de chaîne des SID qui correspondent aux principaux choisis par l’utilisateur.

Il s’agit d’une variante qui contient un objet SAFEARRAY ou JScript Array . Chaque élément du tableau contient une VT_BSTR qui contient une représentation sous forme de chaîne d’un SID.

Valeur retournée

Si la méthode réussit, elle retourne S_OK.

En cas d'échec de la méthode, retourne un code d'erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	azroles.h

Partager via