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

Статья
08/22/2023

Определяет, установлена ли служба кластеров и запущена на узле. Тип PCLUSAPI_GET_NODE_CLUSTER_STATE определяет указатель на эту функцию.

Синтаксис

DWORD GetNodeClusterState(
  [in, optional] LPCWSTR lpszNodeName,
  [out]          LPDWORD pdwClusterState
);

Параметры

[in, optional] lpszNodeName

Указатель на строку Юникода с пустым завершением, содержащую имя узла для запроса. Если lpszNodeName имеет значение NULL, выполняется запрос к локальному узлу.

[out] pdwClusterState

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

ClusterStateNotInstalled (0)

Служба кластеров не установлена на узле.

ClusterStateNotConfigured (1)

Служба кластеров установлена на узле, но еще не настроена.

ClusterStateNotRunning (3)

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

ClusterStateRunning (19 (0x13))

Служба кластеров устанавливается, настраивается и работает на узле.

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

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

Требования

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

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

NODE_CLUSTER_STATE

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

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