Metode IAzClientContext::GetRoles (azroles.h)

Metode GetRoles mengembalikan peran untuk konteks klien.

Sintaks

HRESULT GetRoles(
  [in, optional] BSTR    bstrScopeName,
  [out]          VARIANT *pvarRoleNames
);

Parameter

[in, optional] bstrScopeName

Nama objek IAzScope tempat peran yang dikembalikan dalam parameter pvarRoleNames berlaku. Jika properti ini NULL, peran dari cakupan aplikasi dikembalikan; jika tidak, peran dari cakupan yang ditentukan dikembalikan alih-alih peran dari cakupan aplikasi.

[out] pvarRoleNames

Pointer ke VARIAN yang digunakan untuk mengembalikan SAFEARRAY. Setiap elemen SAFEARRAY adalah VARIAN jenis BSTR yang berisi nama peran tempat klien berada pada cakupan yang ditentukan oleh parameter bstrScopeName .

Menampilkan nilai

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan. Nilai lain menunjukkan bahwa operasi gagal.

Keterangan

Di JScript, SAFEARRAY yang dikembalikan harus dikonversi ke objek JScript Array .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	azroles.h
Pustaka	Azroles.lib
DLL	Azroles.dll
Redistribusi	Paket Alat Administrasi Windows Server 2003 di Windows XP