IGetClusterResourceInfo::GetResourceNetworkName method

[This method is available for use in the operating systems specified in the Requirements section. Support for this method was removed in Windows Server 2008.]

Returns the name of the network managed by the Network Name resource on which a resource depends.

Syntax

BOOL GetResourceNetworkName(
  LONG  lObjIndex,
  BSTR  lpszNetName,
  ULONG *pcchNetName
);

Parameters

lObjIndex

A number representing the zero-based index of the target resource. The target resource may or may not depend on a Network Name resource. lObjIndex is restricted to the number that can be retrieved by calling IGetClusterDataInfo::GetObjectCount.

lpszNetName

Pointer to a null-terminated Unicode string containing the name of the network upon which the resource indexed by lObjIndex depends. Although declared as a BSTR, this parameter is implemented as an LPWSTR.

pcchNetName

Pointer to the maximum count in characters of the buffer pointed to by lpszNetName. On input, this value should be large enough to contain MAX_COMPUTERNAME_LENGTH + 1 characters. On output, pcchNetName points to the actual number of characters copied to the content of lpszNetName.

Return Value

This method returns BOOL.

Remarks

The GetResourceNetworkName method is necessary to allow Failover Cluster Administrator extension property pages to determine whether a resource has an existing or a pending dependency on a Network Name resource.

The name of the network is stored in the Network Name resource's Name private property. The Network Name resource's Name common property is the name of the resource, not the network.

MAX_COMPUTERNAME_LENGTH is a constant defined as 15 in the Windows header file WinBase.h.

Requirements

   
Windows version None supported Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Target Platform Windows
Header cluadmex.h

See Also

IGetClusterDataInfo::GetObjectCount

IGetClusterResourceInfo