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

Статья
02/23/2024

Перечисляет объекты в кластере, а затем получает имя и свойства объекта кластера.

Синтаксис

DWORD ClusterEnumEx(
  [in]      HCLUSENUMEX        hClusterEnum,
  [in]      DWORD              dwIndex,
  [in, out] PCLUSTER_ENUM_ITEM pItem,
  [in, out] LPDWORD            cbItem
);

Параметры

[in] hClusterEnum

Дескриптор перечислителя, возвращаемый функцией ClusterOpenEnumEx .

[in] dwIndex

Индекс, определяющий следующий объект кластера для перечисления. Этот параметр должен иметь нулевое значение для первого вызова функции ClusterEnumEx , а затем увеличиваться для последующих вызовов.

[in, out] pItem

Указатель, получающий возвращаемые свойства объекта кластера.

[in, out] cbItem

На входных данных — размер параметра pItem .

На выходе — требуемый размер буфера в байтах, если буфер слишком мал, или число байтов, записанных в буфер.

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

Код возврата	Описание
ERROR_NO_MORE_ITEMS	Параметр dwIndex больше, чем количество элементов в перечислении.
ERROR_MORE_DATA	Буфер слишком мал.
ERROR_SUCCESS	Буфер успешно заполнен.

Требования

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

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

CLUSTER_ENUM_ITEM

Функция управления отказоустойчивости кластеров

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