Metodo IAzObjectPicker::GetPrincipals (azroles.h)

Il metodo GetPrincipals visualizza una finestra di dialogo da cui gli utenti possono scegliere una o più entità e quindi restituisce l'elenco scelto di entità e i relativi IDENTIFICATORi di sicurezza (SID).

Sintassi

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

Parametri

[in] hParentWnd

Handle per la finestra padre della finestra di dialogo.

[in] bstrTitle

Titolo visualizzato della finestra di dialogo.

[out] pvSidTypes

Puntatore a una matrice di elementi dell'enumerazione SID_NAME_USE che specificano i tipi dei SID corrispondenti alle entità scelte dall'utente.

Si tratta di una variante che contiene un oggetto SAFEARRAY o JScript Array . Ogni elemento della matrice contiene un valore VT_I4 che specifica un elemento dell'enumerazione SID_NAME_USE .

[out] pvNames

Puntatore a una matrice di nomi visualizzati delle entità scelte dall'utente.

Si tratta di una variante che contiene un oggetto SAFEARRAY o JScript Array . Ogni elemento della matrice contiene un VT_BSTR che contiene un nome visualizzato.

[out] pvSids

Puntatore a una matrice di rappresentazioni di stringa dei SID che corrispondono alle entità scelte dall'utente.

Si tratta di una variante che contiene un oggetto SAFEARRAY o JScript Array . Ogni elemento della matrice contiene un VT_BSTR che contiene una rappresentazione di stringa di un SID.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK.

Se il metodo ha esito negativo, viene restituito un codice errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	azroles.h