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

一组标志，用于修改此方法的行为。这可以是零，也可以是以下一个或多个值的组合。

值	含义
AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY 0x2	此方法仅在存储级别检查应用程序组。

[out] pGroupArray

指向与此客户端上下文关联的应用程序组名称数组的指针。

这是一个包含 SAFEARRAY 或 JScript Array 对象的变体。数组的每个元素都包含一个包含应用程序组名称 的VT_BSTR 。

如果方法成功，则返回 S_OK。

如果方法失败，则返回错误代码。有关常见错误代码的列表，请参阅通用 HRESULT 值。