Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

GetClusterFromNetInterface function

Returns a handle to the cluster associated with a network interface. The PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE type defines a pointer to this function.

Syntax


HCLUSTER WINAPI GetClusterFromNetInterface(
  _In_ HNETINTERFACE hNetInterface
);

typedef HCLUSTER (WINAPI *PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE)(
    _In_ HNETINTERFACE hNetInterface
);

Parameters

hNetInterface [in]

Handle to the network interface.

Return value

If the operation succeeds, the function returns a handle to the cluster that owns the network interface.

If the operation fails, the function returns NULL. For more information about the error, call GetLastError.

Remarks

For hNetInterface to be a valid handle, there must necessarily be an open cluster handle (see OpenClusterNetInterface). GetClusterFromNetInterface returns another instance of the handle from which hNetInterface was obtained.

Be sure to call CloseCluster on the handle returned from GetClusterFromNetInterface before the handle goes out of scope. Closing this handle does not invalidate hNetInterface or the cluster handle from which hNetInterface was obtained.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Enterprise, Windows Server 2008 Datacenter

Header

ClusAPI.h

Library

ClusAPI.lib

DLL

ClusAPI.dll

See also

GetClusterFromGroup
GetClusterFromNetwork
GetClusterFromNode
GetClusterFromResource
CloseCluster
OpenCluster
OpenClusterNetInterface
CloseClusterNetInterface

 

 

Show: