Metode IAzClientContext2::GetAssignedScopesPage (azroles.h)

  • Artikel

Metode GetAssignedScopesPage mengambil daftar cakupan di mana klien yang diwakili oleh objek IAzClientContext2 saat ini ditetapkan ke setidaknya satu peran.

Sintaks

HRESULT GetAssignedScopesPage(
  [in]      LONG    lOptions,
  [in]      LONG    PageSize,
  [in, out] VARIANT *pvarCursor,
            VARIANT *pvarScopeNames
);

Parameter

[in] lOptions

Bendera yang menentukan apakah metode ini memeriksa grup kueri LDAP untuk penetapan cakupan. Grup kueri LDAP yang di-cache sebelumnya diperiksa terlepas dari nilai bendera ini.

Nilai Makna
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY
1
 Grup kueri LDAP yang sebelumnya tidak di-cache tidak diperiksa.

[in] PageSize

Jumlah elemen di setiap hasil halaman.

[in, out] pvarCursor

Penunjuk ke VARIAN yang mewakili halaman hasil saat ini. Untuk panggilan pertama ke metode GetAssignedScopesPage, teruskanVT_EMPTY sebagai nilai untuk parameter ini untuk mengambil halaman pertama hasil. Jumlah elemen pada halaman ditentukan oleh nilai parameter PageSize . Pada output, parameter ini berisi nilai yang akan diteruskan dalam panggilan berikutnya ke GetAssignedScopesPage untuk mengambil halaman hasil berikutnya. Jika nilai parameter ini pada output KOSONG, tidak ada lagi halaman hasil.

pvarScopeNames

Saat dikembalikan, berisi array variabel jenis VARIAN. Setiap elemen array berjenis VT_BSTR dan berisi nama cakupan tempat klien saat ini ditetapkan. Jumlah elemen dalam array ditentukan oleh parameter PageSize .

Menampilkan nilai

Jika metode berhasil, metode akan mengembalikan S_OK.

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

Keterangan

Jika beberapa utas mengakses penyimpanan otorisasi yang sama, panggilan ke metode GetAssignedScopesPage pada salah satu utas mungkin tidak mengembalikan hasil yang akurat jika utas lain memodifikasi penyimpanan.

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2008, Windows Server 2003 dengan SP1 [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