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 |