GetClusterNetInterfaceKey function (clusapi.h)

Opens the root of the cluster database subtree for a network interface object.

Syntax

HKEY GetClusterNetInterfaceKey(
  [in] HNETINTERFACE hNetInterface,
  [in] REGSAM        samDesired
);

Parameters

[in] hNetInterface

Handle to a network interface.

[in] samDesired

Access mask that describes the security access needed for the key.

Return value

If the operation succeeds, the function returns a registry key handle for the network interface.

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

Remarks

The GetClusterNetInterfaceKey function returns a handle to a cluster database key representing the subtree root for the network interface identified by hNetInterface. Callers should call ClusterRegCloseKey to close the key handle retrieved by GetClusterNetInterfaceKey when they are done with it.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Target Platform Windows
Header clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

See also

ClusterRegCloseKey

OpenClusterNetInterface