IAzObjectPicker::GetPrincipals-Methode (azroles.h)

Die GetPrincipals-Methode zeigt ein Dialogfeld an, in dem Benutzer einen oder mehrere Prinzipale auswählen können, und gibt dann die ausgewählte Liste der Prinzipale und die entsprechenden Sicherheits-IDs (SIDs) zurück.

Syntax

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

Parameter

[in] hParentWnd

Ein Handle für das übergeordnete Fenster des Dialogfelds.

[in] bstrTitle

Der Anzeigetitel des Dialogfelds.

[out] pvSidTypes

Ein Zeiger auf ein Array von Elementen der SID_NAME_USE Enumeration, die die Typen der SIDs angeben, die den vom Benutzer ausgewählten Prinzipalen entsprechen.

Dies ist eine Variante, die entweder ein SAFEARRAY - oder das JScript-Array-Objekt enthält. Jedes Element des Arrays enthält einen VT_I4 Wert, der ein Element der SID_NAME_USE-Enumeration angibt.

[out] pvNames

Ein Zeiger auf ein Array von Anzeigenamen der vom Benutzer ausgewählten Prinzipale.

Dies ist eine Variante, die entweder ein SAFEARRAY - oder das JScript-Array-Objekt enthält. Jedes Element des Arrays enthält eine VT_BSTR , die einen Anzeigenamen enthält.

[out] pvSids

Ein Zeiger auf ein Array von Zeichenfolgendarstellungen der SIDs, die den vom Benutzer ausgewählten Prinzipalen entsprechen.

Dies ist eine Variante, die entweder ein SAFEARRAY - oder das JScript-Array-Objekt enthält. Jedes Element des Arrays enthält eine VT_BSTR , die eine Zeichenfolgendarstellung einer SID enthält.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

Bei einem Fehler gibt diese Methode einen Fehlercode zurück. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h