通过

OpenClusterResourceEx 函数 (clusapi.h)

  • 项目

打开 资源 并返回一个句柄。

语法

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

参数

[in] hCluster

群集的句柄。

[in, optional] lpszResourceName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要打开的资源的名称。

资源名称不区分大小写。 资源名称在群集中必须是唯一的。 该名称是在创建资源时设置的，可以使用 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 Enterprise
目标平台 Windows
标头 clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

另请参阅

CloseClusterResource

故障转移群集资源管理功能

OpenClusterResource