GetClusterNetinterface

The GetClusterNetInterface function returns the name of a node's interface to a network in a cluster.

DWORD WINAPI GetClusterNetInterface(
  HCLUSTER hCluster,
  LPCWSTR lpszNodeName,
  LPCWSTR lpszNetworkName,
  LPWSTR lpszInterfaceName,
  LPDWORD lpcbInterfaceName
);
 

Parameters

hCluster
[in] Handle to a cluster.
lpszNodeName
[in] Pointer to the name of the node in the cluster.
lpszNetworkName
[in] Pointer to the name of the network.
lpszInterfaceName
[out] Pointer to an output buffer holding the name of the network interface.
lpcbInterfaceName
[in, out] On input, pointer to a variable that specifies the size, in characters, of the buffer pointed to by lpszInterfaceName, including the terminating NULL character. On output, pointer to a variable that contains the number of characters stored in the output buffer not including the terminating NULL character.

Return Values

ERROR_SUCCESS
The network interface name was returned successfully.
ERROR_MORE_DATA
The name to be returned is longer than can fit in the buffer pointed to by lpszInterfaceName.

If the operation was unsuccessful, GetClusterNetInterface can also return a Win32 error.

QuickInfo

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