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

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

  • Статья

Перечисляет сетевые интерфейсы, установленные в кластере, возвращая по одному имени при каждом вызове.

Синтаксис

DWORD ClusterNetInterfaceEnum(
  [in]      HNETINTERFACEENUM hNetInterfaceEnum,
  [in]      DWORD             dwIndex,
  [out]     LPWSTR            lpszName,
  [in, out] LPDWORD           lpcchName
);

Параметры

[in] hNetInterfaceEnum

Обработка существующего объекта перечисления, первоначально возвращенного функцией ClusterNetInterfaceOpenum .

[in] dwIndex

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

[out] lpszName

Указатель на строку Юникода с пустым завершением, содержащую имя возвращаемого объекта.

[in, out] lpcchName

Указатель на размер буфера lpszName в символах. На входных данных укажите максимальное число символов, которые может содержать буфер, включая завершающее значение NULL. В выходных данных указывает количество символов в результирующем имени, исключая завершающее значение NULL.

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

Функция возвращает одно из следующих значений.

Возвращаемый код или значение Описание
ERROR_SUCCESS
0
 Операция выполнена успешно.
ERROR_NO_MORE_ITEMS
259 (0x103)
 Больше нет доступных данных. Это значение возвращается, если больше нет объектов для возврата.
ERROR_MORE_DATA
234 (0xEA)
 More data is available. Это значение возвращается, если буфер, на который указывает lpszName, недостаточно велик для хранения результата. Параметр lpcchName возвращает количество символов в результате, за исключением завершающего значения NULL.

Требования

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