Функция OpenClusterGroupEx (clusapi.h)

Статья
03/09/2023

Открывает группу отказоустойчивого кластера и возвращает ей дескриптор.

Синтаксис

HGROUP OpenClusterGroupEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszGroupName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Параметры

[in] hCluster

Обработка кластера, включающего группу для открытия.

[in, optional] lpszGroupName

Имя открываемой группы.

[in] dwDesiredAccess

Запрошенные привилегии доступа. Это может быть любое сочетание GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) или MAXIMUM_ALLOWED (0x02000000). Если это значение равно нулю (0) и может быть возвращена неопределенная ошибка. Использование GENERIC_ALL аналогично вызову OpenClusterGroup.

[out, optional] lpdwGrantedAccess

Необязательный параметр, содержащий адрес DWORD , который получит предоставленные права доступа. Если параметр DesiredAccess имеет значение MAXIMUM_ALLOWED (0x02000000), то параметр DWORD , на который указывает этот параметр, будет содержать максимальные привилегии, предоставленные этому пользователю.

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

Если операция прошла успешно, OpenClusterGroupEx возвращает дескриптор группы.

Код возврата	Описание
NULL	Операция не была успешной. Для получения дополнительных сведений об ошибке вызовите функцию GetLastError . Если целевой сервер не поддерживает функцию OpenClusterGroupEx (например, если целевой сервер работает под управлением Windows Server 2008 или более ранней версии), функция GetLastError вернет RPC_S_PROCNUM_OUT_OF_RANGE (1745).

Код возврата

Описание

NULL

Операция не была успешной. Для получения дополнительных сведений об ошибке вызовите функцию GetLastError . Если целевой сервер не поддерживает функцию OpenClusterGroupEx (например, если целевой сервер работает под управлением Windows Server 2008 или более ранней версии), функция GetLastError вернет RPC_S_PROCNUM_OUT_OF_RANGE (1745).

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise
Целевая платформа	Windows
Header	clusapi.h
Библиотека	ClusAPI.lib
DLL	ClusAPI.dll

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

CloseClusterGroup

Функции управления группами

OpenClusterGroup

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