Функция OpenClusterNodeEx (clusapi.h)
Открывает узел и возвращает ему дескриптор.
Синтаксис
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 возвращает дескриптор узла.
| Код возврата | Описание |
|---|---|
|
Операция не была успешной. Для получения дополнительных сведений об ошибке вызовите функцию 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 |