IAzClientContext3::GetGroups メソッド (azroles.h)

GetGroups メソッドは、このクライアントコンテキストに関連付けられているアプリケーショングループの配列を返します。

構文

HRESULT GetGroups(
  [in]  BSTR    bstrScopeName,
  [in]  ULONG   ulOptions,
  [out] VARIANT *pGroupArray
);

[in] bstrScopeName

アプリケーショングループのチェックするスコープの名前。 ulOptions パラメーターの値が AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY に設定されている場合、このパラメーターは無視されます。

[in] ulOptions

このメソッドの動作を変更するフラグのセット。これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

値	意味
AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY 0x2	このメソッドは、ストアレベルのアプリケーショングループのみをチェックします。

[out] pGroupArray

このクライアントコンテキストに関連付けられているアプリケーショングループの名前の配列へのポインター。

これは、 SAFEARRAY オブジェクトまたは JScript Array オブジェクトを含むバリアントです。配列の各要素は、アプリケーショングループの名前を含む VT_BSTR を保持します。

メソッドが成功すると、 S_OKが返されます。

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