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

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

  • Статья

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

Синтаксис

HRESOURCE OpenClusterResourceEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszResourceName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Параметры

[in] hCluster

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

[in, optional] lpszResourceName

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

В именах ресурсов регистр не учитывается. Имя ресурса должно быть уникальным в пределах кластера. Имя задается при создании ресурса и может быть изменено с помощью функции SetClusterResourceName .

[in] dwDesiredAccess

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

[out, optional] lpdwGrantedAccess

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

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

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

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

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

CloseClusterResource

Функции управления ресурсами отказоустойчивого кластера

OpenClusterResource