GetClusterResourceNetworkName

The GetClusterResourceNetworkName function retrieves the network name from the Network Name resource on which a resource is dependent.

BOOL WINAPI GetClusterResourceNetworkName(
  HRESOURCE hResource,  
  LPWSTR lpBuffer,      
  LPDWORD nSize         
);
 

Parameters

hResource
[in] Handle to the dependent resource.
lpBuffer

[out] Pointer to a buffer containing a NULL-terminated character string containing the network name of the Network Name resource.

nSize
[in, out] On input, pointer to a count of characters in the buffer pointed to by lpBuffer. On output, pointer to a count of characters in the network name of the Network Name resource contained in the buffer pointed to by lpBuffer, excluding the terminating NULL character.

Return Values

TRUE
The operation was successful.
FALSE
The operation was unsuccessful.

Remarks

Applications and resource DLLs call GetClusterResourceNetworkName to enumerate the dependencies of the resource identified by hResource in an attempt to find a Network Name resource on which the resource depends. GetClusterResourceNetworkName can help third-party developers determine the network name that their applications should be using.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.