IAzClientContext2::GetAssignedScopesPage メソッド (azroles.h)

GetAssignedScopesPage メソッドは、現在の IAzClientContext2 オブジェクトによって表されるクライアントが少なくとも 1 つのロールに割り当てられているスコープの一覧を取得します。

構文

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

パラメーター

[in] lOptions

このメソッドがスコープの割り当てについて LDAP クエリ グループをチェックするかどうかを指定するフラグ。 以前にキャッシュされた LDAP クエリ グループは、このフラグの値に関係なくチェックされます。

値	意味
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	以前にキャッシュされなかった LDAP クエリ グループはチェックされません。

[in] PageSize

各ページの結果の要素の数。

[in, out] pvarCursor

結果の現在のページを表す VARIANT へのポインター。 GetAssignedScopesPage メソッドの最初の呼び出しでは、このパラメーターの値として VT_EMPTYを渡して、結果の最初のページを取得します。 ページ上の要素の数は、 PageSize パラメーターの値によって決まります。 出力時に、このパラメーターには、 GetAssignedScopesPage の次の呼び出しで結果の次のページを取得するために渡される値が含まれます。 出力時のこのパラメーターの値が EMPTY の場合、結果ページはこれ以上ありません。

pvarScopeNames

戻り値には、 VARIANT 型の変数の配列が含まれます。 配列の各要素は VT_BSTR 型であり、現在のクライアントが割り当てられているスコープの名前を含みます。 配列内の要素の数は、 PageSize パラメーターによって指定されます。

戻り値

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

注釈

複数のスレッドが同じ承認ストアにアクセスする場合、いずれかのスレッドで GetAssignedScopesPage メソッドを呼び出しても、他のスレッドがストアを変更した場合、正確な結果が返されない可能性があります。

JScript では、返される SAFEARRAY 値を JScript Array オブジェクトに変換する必要があります。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008、Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	azroles.h
Library	Azroles.lib
[DLL]	Azroles.dll
再頒布可能パッケージ	Windows XP の Windows Server 2003 管理ツール パック