Skip to content

Latest commit

 

History

History
120 lines (95 loc) · 4.04 KB

nf-clusapi-openclusternetinterfaceex.md

File metadata and controls

120 lines (95 loc) · 4.04 KB
Raw
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.OpenClusterNetInterfaceEx
OpenClusterNetInterfaceEx function (clusapi.h)
Opens a handle to a network interface. (OpenClusterNetInterfaceEx)
OpenClusterNetInterfaceEx
OpenClusterNetInterfaceEx function [Failover Cluster]
PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX
PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX function [Failover Cluster]
clusapi/OpenClusterNetInterfaceEx
clusapi/PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX
mscs.openclusternetinterfaceex
mscs\openclusternetinterfaceex.htm
MsCS
207d6888-35ff-44d4-aac0-915815b9730d
12/05/2018
OpenClusterNetInterfaceEx, OpenClusterNetInterfaceEx function [Failover Cluster], PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX, PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX function [Failover Cluster], clusapi/OpenClusterNetInterfaceEx, clusapi/PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX, mscs.openclusternetinterfaceex
clusapi.h
Windows
None supported
Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise
ClusAPI.lib
ClusAPI.dll
Windows
19H1
OpenClusterNetInterfaceEx
clusapi/OpenClusterNetInterfaceEx
c++
APIRef
kbSyntax
DllExport
ClusAPI.dll
OpenClusterNetInterfaceEx

OpenClusterNetInterfaceEx function

-description

Opens a handle to a network interface.

-parameters

-param hCluster [in]

Handle to a cluster.

-param lpszInterfaceName [in, optional]

Pointer to a null-terminated Unicode string containing the name of the network interface to open.

-param dwDesiredAccess [in]

The requested access privileges. This may be any combination of GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000), or MAXIMUM_ALLOWED (0x02000000). If this value is zero (0) and undefined error may be returned. Using GENERIC_ALL is the same as calling OpenClusterNetInterface.

-param lpdwGrantedAccess [out, optional]

Optional parameter that contains the address of a DWORD that will receive the access rights granted. If the DesiredAccess parameter is MAXIMUM_ALLOWED (0x02000000) then the DWORD pointed to by this parameter will contain the maximum privileges granted to this user.

-returns

If the operation was successful, OpenClusterNetInterfaceEx returns an open handle to the specified network interface.

Return code Description
NULL
 The operation was not successful. For more information about the error, call the GetLastError function. If the target server does not support the OpenClusterNetInterfaceEx function (for example if the target server is running Windows Server 2008 or earlier) then the GetLastError function will return RPC_S_PROCNUM_OUT_OF_RANGE (1745).

-see-also

CloseClusterNetInterface

Network Interface Management Functions

OpenClusterNetInterface