IAzObjectPicker::GetPrincipals method (azroles.h)

Artikel
02/28/2024

Metode GetPrincipals menampilkan kotak dialog tempat pengguna dapat memilih satu atau beberapa prinsipal, lalu mengembalikan daftar prinsipal yang dipilih dan pengidentifikasi keamanan (SID) yang sesuai.

Sintaks

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

Parameter

[in] hParentWnd

Handel ke jendela induk kotak dialog.

[in] bstrTitle

Judul tampilan kotak dialog.

[out] pvSidTypes

Penunjuk ke array elemen enumerasi SID_NAME_USE yang menentukan jenis SID yang sesuai dengan prinsipal yang dipilih oleh pengguna.

Ini adalah varian yang berisi SAFEARRAY atau objek JScript Array . Setiap elemen array menyimpan nilai VT_I4 yang menentukan elemen enumerasi SID_NAME_USE .

[out] pvNames

Penunjuk ke array nama tampilan prinsipal yang dipilih oleh pengguna.

Ini adalah varian yang berisi SAFEARRAY atau objek JScript Array . Setiap elemen array menyimpan VT_BSTR yang berisi nama tampilan.

[out] pvSids

Penunjuk ke array representasi string dari SID yang sesuai dengan prinsipal yang dipilih oleh pengguna.

Ini adalah varian yang berisi SAFEARRAY atau objek JScript Array . Setiap elemen array menyimpan VT_BSTR yang berisi representasi string SID.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK.

Jika metode gagal, metode mengembalikan kode kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	azroles.h

Bagikan melalui