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

Открывает дескриптор сетевого интерфейса.

Синтаксис

HNETINTERFACE OpenClusterNetInterfaceEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszInterfaceName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Параметры

[in] hCluster

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

[in, optional] lpszInterfaceName

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

[in] dwDesiredAccess

Запрошенные привилегии доступа. Это может быть любое сочетание GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) или MAXIMUM_ALLOWED (0x02000000). Если это значение равно нулю (0) и может быть возвращена неопределенная ошибка. Использование GENERIC_ALL аналогично вызову OpenClusterNetInterface.

[out, optional] lpdwGrantedAccess

Необязательный параметр, содержащий адрес DWORD , который получит предоставленные права доступа. Если параметр DesiredAccess имеет MAXIMUM_ALLOWED (0x02000000), то параметр DWORD , на который указывает этот параметр, будет содержать максимальные привилегии, предоставленные этому пользователю.

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

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

Код возврата	Описание
NULL	Операция не была успешной. Для получения дополнительных сведений об ошибке вызовите функцию GetLastError . Если целевой сервер не поддерживает функцию OpenClusterNetInterfaceEx (например, если целевой сервер работает под управлением Windows Server 2008 или более ранней версии), функция GetLastError вернет RPC_S_PROCNUM_OUT_OF_RANGE (1745).

Требования

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

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

CloseClusterNetInterface

Функции управления сетевым интерфейсом

OpenClusterNetInterface