Функция 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.
Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведены возможные коды ошибок.
| Код возврата | Описание |
|---|---|
|
Подходящий узел узла был недоступен. |
|
Операция выполняется. |
Комментарии
Если группа не может быть подключена к сети на узле, определяемом параметром 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 |