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

Статья
02/24/2024

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

Синтаксис

HCLUSTER GetClusterFromNetInterface(
  [in] HNETINTERFACE hNetInterface
);

Параметры

[in] hNetInterface

Дескриптор сетевого интерфейса.

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

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

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

Чтобы hNetInterface был допустимым дескриптором, обязательно должен быть открытый дескриптор кластера (см. раздел OpenClusterNetInterface). GetClusterFromNetInterface возвращает другой экземпляр дескриптора, из которого был получен hNetInterface .

Не забудьте вызвать CloseCluster для дескриптора, возвращаемого из GetClusterFromNetInterface, прежде чем дескриптор выйдет из область. Закрытие этого дескриптора не делает недействительным hNetInterface или дескриптор кластера, из которого был получен hNetInterface .

Требования

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