Метод IAzClientContext3::GetGroups (azroles.h)

Статья
08/22/2023

Метод 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. Каждый элемент массива содержит VT_BSTR , содержащий имя группы приложений.

Возвращаемое значение

Если метод завершается успешно, он возвращает S_OK.

Если происходит сбой метода, он возвращает код ошибки. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	azroles.h

См. также раздел

IAzClientContext3

Поделиться через