[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.]
BOOL GetResourceNetworkName( LONG lObjIndex, BSTR lpszNetName, ULONG *pcchNetName );
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.
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.
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.
This method returns BOOL.
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.
|Windows version||None supported Windows Server 2003 Enterprise, Windows Server 2003 Datacenter|