GetClusterNetInterfaceKey

The GetClusterNetInterfaceKey function opens the root of the cluster database subtree for a network interface object.

HKEY WINAPI GetClusterNetInterfaceKey(
  HNETINTERFACE hNetInterface,       
  REGSAM samDesired  
);
 

Parameters

hNetInterface

[in] Handle to a network interface.

samDesired

[in] Access mask that describes the desired security access for the new key.

Return Values

NULL

The operation was unsuccessful. For more detailed information about the error, see the Win32 function GetLastError.

If the operation was successful, GetClusterNetInterfaceKey returns a registry key handle for the network interface.

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.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.