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

Статья
08/22/2023

Переводит группу в режим "в сети".

Синтаксис

DWORD OnlineClusterGroupEx(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode,
  [in]           DWORD  dwOnlineFlags,
  [in, optional] PBYTE  lpInBuffer,
  [in]           DWORD  cbInBufferSize
);

Параметры

[in] hGroup

Дескриптор группы, который нужно подключить к сети.

[in, optional] hDestinationNode

Дескриптор узла , на котором размещается группа.

[in] dwOnlineFlags

Флаг , указывающий параметры для ресурса, который должен быть подключен.

CLUSAPI_GROUP_ONLINE_IGNORE_RESOURCE_STATUS (0x00000001)

Сервер игнорирует заблокированный режим для ресурса.

CLUSAPI_GROUP_ONLINE_SYNCHRONOUS (0x00000002)

Используйте синхронную операцию для подключения группы к сети.

Windows Server 2012 R2 и Windows Server 2012: Это значение было добавлено в Windows Server 2016.

CLUSAPI_GROUP_ONLINE_BEST_POSSIBLE_NODE (0x00000004)

Пусть служба кластера определяет узел, на котором будет размещаться группа при ее подключении.

Windows Server 2012 R2 и Windows Server 2012: Это значение было добавлено в Windows Server 2016.

0

Сервер не пропускает заблокированный режим для ресурса.

[in, optional] lpInBuffer

Указатель на входной буфер, который получает инструкции для операции. Параметр lpInBuffer форматируется как список свойств.

[in] cbInBufferSize

Размер параметра lpInBuffer в байтах.

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

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

Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведены возможные коды ошибок.

Код возврата	Описание
ERROR_HOST_NODE_NOT_AVAILABLE	Подходящий узел узла был недоступен.
ERROR_IO_PENDING	Операция выполняется.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	clusapi.h
Библиотека	ClusAPI.lib
DLL	ClusAPI.dll

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

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

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