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

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

  • Статья

Возвращает имя интерфейса узла для сети в кластере. Тип PCLUSAPI_GET_CLUSTER_NET_INTERFACE определяет указатель на эту функцию.

Синтаксис

DWORD GetClusterNetInterface(
  [in]      HCLUSTER hCluster,
  [in]      LPCWSTR  lpszNodeName,
  [in]      LPCWSTR  lpszNetworkName,
  [out]     LPWSTR   lpszInterfaceName,
  [in, out] LPDWORD  lpcchInterfaceName
);

Параметры

[in] hCluster

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

[in] lpszNodeName

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

[in] lpszNetworkName

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

[out] lpszInterfaceName

Указатель на выходной буфер, содержащий имя сетевого интерфейса.

[in, out] lpcchInterfaceName

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

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

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

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

Код возврата Описание
ERROR_MORE_DATA
 Буфер, на который указывает lpszInterfaceName , недостаточно велик для хранения результата. Параметр lpcchInterfaceName возвращает количество символов в результате, за исключением завершающего значения NULL.

Комментарии

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

Требования

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

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

OpenCluster