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

  • Статья

Переводит группу в режим "в сети". Тип PCLUSAPI_ONLINE_CLUSTER_GROUP определяет указатель на эту функцию.

Синтаксис

DWORD OnlineClusterGroup(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode
);

Параметры

[in] hGroup

Дескриптор в группу, для подключения к сети.

[in, optional] hDestinationNode

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

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

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

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

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

Комментарии

Если группа не может быть подключена к сети на узле, определяемом параметром hDestinationNode , функция OnlineClusterGroup завершается ошибкой.

Если параметру hDestinationNode присвоено значение NULL, OnlineClusterGroup переводит группу в режим "в сети" на текущем узле.

Не вызывайте OnlineClusterGroup из библиотеки DLL ресурса. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.

Не передайте маркеры LPC и RPC в один вызов функции. В противном случае вызов вызовет исключение RPC и может иметь дополнительные разрушительные последствия. Сведения о создании дескрипторов LPC и RPC см. в разделе Использование дескрипторов объектов и OpenCluster.

Требования

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

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

OfflineClusterGroup

OpenCluster

OpenClusterGroup