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

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

  • Статья

Извлекает элемент в перечислении . Тип PCLUSAPI_CLUSTER_GROUP_ENUM_EX определяет указатель на эту функцию.

Синтаксис

DWORD ClusterGroupEnumEx(
  [in]      HGROUPENUMEX             hGroupEnumEx,
  [in]      DWORD                    dwIndex,
  [in, out] PCLUSTER_GROUP_ENUM_ITEM pItem,
  [in, out] LPDWORD                  cbItem
);

Параметры

[in] hGroupEnumEx

Дескриптор перечисления, из которого будет извлечен элемент.

[in] dwIndex

Отсчитываемый от нуля индекс элемента в перечислении.

[in, out] pItem

Указатель на заполняемый буфер.

[in, out] cbItem

Во входных данных — размер pItem.

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

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

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

Комментарии

Функция ClusterGroupEnumEx не подключается к кластеру, так как hGroupEnumEx уже содержит данные перечисления. Данные копируются в буфер, но данные не извлекаются из кластера.

Требования

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