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

Статья
02/23/2024

Открывает перечислитель для перебора сетевых интерфейсов.
или групп, установленных на узле. Тип PCLUSAPI_CLUSTER_NODE_OPEN_ENUM определяет указатель на эту функцию.

Синтаксис

HNODEENUM ClusterNodeOpenEnum(
  [in] HNODE hNode,
  [in] DWORD dwType
);

Параметры

[in] hNode

Дескриптор узла.

[in] dwType

Битовая маска, описывающая тип перечисляемых объектов. Допустимы следующие значения перечисления CLUSTER_NODE_ENUM .

CLUSTER_NODE_ENUM_NETINTERFACES (0x00000001)

Перечисление объектов сетевого интерфейса на узле.

CLUSTER_NODE_ENUM_GROUPS (0x00000002)

Перечисление групп кластеров на узле.

CLUSTER_NODE_ENUM_ALL ((CLUSTER_NODE_ENUM_NETINTERFACES | CLUSTER_NODE_ENUM_GROUPS))

Перечисление объектов сетевых интерфейсов и групп кластеров на узле.

Windows Server 2008: Значение CLUSTER_NODE_ENUM_GROUPS не поддерживается до Windows Server 2008 R2.

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

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

Если операция завершается сбоем, функция возвращает значение NULL. Для получения дополнительных сведений об ошибке вызовите функцию GetLastError .

Функция ClusterNodeOpenum возвращает дескриптор, который можно передать в ClusterNodeEnum для доступа к каждому из перечисляемых объектов, и в ClusterNodeCloseEnum для освобождения перечислителя.

Примеры

См. раздел Перечисление объектов.

Требования

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