Skip to content

Latest commit

 

History

History
104 lines (68 loc) · 3.86 KB

nf-clusapi-getclusterfromnetinterface.md

File metadata and controls

104 lines (68 loc) · 3.86 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:clusapi.GetClusterFromNetInterface
GetClusterFromNetInterface function (clusapi.h)
Returns a handle to the cluster associated with a network interface.
GetClusterFromNetInterface
GetClusterFromNetInterface function [Failover Cluster]
PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE
PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE function [Failover Cluster]
_wolf_getclusterfromnetinterface
clusapi/GetClusterFromNetInterface
clusapi/PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE
mscs.getclusterfromnetinterface
mscs\getclusterfromnetinterface.htm
MsCS
7c6c6883-0d88-4162-a70d-cb6f1153226e
12/05/2018
GetClusterFromNetInterface, GetClusterFromNetInterface function [Failover Cluster], PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE, PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE function [Failover Cluster], _wolf_getclusterfromnetinterface, clusapi/GetClusterFromNetInterface, clusapi/PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE, mscs.getclusterfromnetinterface
clusapi.h
Windows
None supported
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
ClusAPI.lib
ClusAPI.dll
Windows
19H1
GetClusterFromNetInterface
clusapi/GetClusterFromNetInterface
c++
APIRef
kbSyntax
DllExport
ClusAPI.dll
GetClusterFromNetInterface

GetClusterFromNetInterface function

-description

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.

-parameters

-param hNetInterface [in]

Handle to the network interface.

-returns

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.

-see-also

CloseCluster

CloseClusterNetInterface

GetClusterFromGroup

GetClusterFromNetwork

GetClusterFromNode

GetClusterFromResource

OpenCluster

OpenClusterNetInterface