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.