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

Статья
08/22/2023

Открывает узел и возвращает ему дескриптор.

Синтаксис

HNODE OpenClusterNodeEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszNodeName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Параметры

[in] hCluster

Дескриптор кластера , возвращаемого функциями OpenCluster или OpenClusterEx .

[in, optional] lpszNodeName

Указатель на netBIOS-имя существующего узла. Если используется DNS-имя узла, функция OpenClusterNodeEx завершится ошибкой , а GetLastError вернет ERROR_CLUSTER_NODE_NOT_FOUND.

[in] dwDesiredAccess

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

[out, optional] lpdwGrantedAccess

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

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

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

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

Код возврата

Описание

NULL

Операция не была успешной. Для получения дополнительных сведений об ошибке вызовите функцию GetLastError . Если целевой сервер не поддерживает функцию OpenClusterNodeEx (например, если целевой сервер работает под управлением 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

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

CloseClusterNode

Функции управления узлами

OpenCluster

OpenClusterEx

OpenClusterNode

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