IGetClusterResourceInfo：：GetResourceNetworkName 方法 (cluadmex.h)

[此方法可用于“要求”部分中指定的操作系统。 Windows Server 2008 中已删除对此方法的支持。]

返回由资源所依赖的网络名称资源所管理的网络的名称。

语法

BOOL GetResourceNetworkName(
  [in]      LONG  lObjIndex,
  [out]     BSTR  lpszNetName,
  [in, out] ULONG *pcchNetName
);

[in] lObjIndex

一个数字，表示目标资源的从零开始的索引。目标资源不一定依赖于网络名称资源。 lObjIndex 限制为可通过调用 IGetClusterDataInfo：：GetObjectCount 检索的数字。

[out] lpszNetName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含 由 lObjIndex 编制索引的资源所依赖的网络的名称。虽然声明为 BSTR，但此参数实现为 LPWSTR。

[in, out] pcchNetName

指向 lpszNetName 指向的缓冲区的最大计数（以字符为单位）的指针。输入时，此值应足够大，以包含 MAX_COMPUTERNAME_LENGTH + 1 个字符。输出时， pcchNetName 指向复制到 lpszNetName 内容的实际字符数。

返回代码/值	说明
TRUE 1	由 lObjIndex 编制索引的资源依赖于网络名称资源，并且已成功返回网络名称。
FALSE 0	由 lObjIndex 编制索引的资源不依赖于网络名称资源。

若要允许故障转移群集管理员扩展属性页确定某个资源对网络名称资源是现有依赖项还是挂起依赖项，GetResourceNetworkName 方法是必需的。

网络名称存储在网络名称资源的 Name 专用属性中。网络名称资源的 Name 公共属性是资源的名称，而不是网络的名称。

MAX_COMPUTERNAME_LENGTH 是 Windows 头文件 WinBase.h 中定义为 15 的常量。

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2003 企业版、Windows Server 2003 Datacenter
目标平台	Windows
标头	cluadmex.h