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

Статья
07/16/2024

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

Синтаксис

HGROUPENUM ClusterGroupOpenEnum(
  [in] HGROUP hGroup,
  [in] DWORD  dwType
);

Параметры

[in] hGroup

Дескриптор группы перечисления.

[in] dwType

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

CLUSTER_GROUP_ENUM_CONTAINS (1)

Перечисляет ресурсы в группе.

CLUSTER_GROUP_ENUM_NODES (2)

Перечисляет узлы в списке предпочитаемых владельцев группы.

CLUSTER_GROUP_ENUM_ALL (3)

Перечисляет ресурсы в группе и предпочитаемых владельцев группы.

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

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

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

Замечания

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

Примеры

См. перечисление объектов.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Не поддерживается
минимальный поддерживаемый сервер	Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
целевая платформа	Виндоус
заголовка	clusapi.h
библиотеки	ClusAPI.lib
DLL	ClusAPI.dll

См. также

ClusterGroupCloseEnum

ClusterGroupEnum

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

OpenClusterGroup

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