NdisOpenProtocolConfiguration (Windows Embedded CE 6.0)

1/6/2010

This function returns a handle for the HKEY_LOCAL_MACHINE\Comm\ProtocolName\Parms registry key.

Syntax

VOID NdisOpenProtocolConfiguration(
  PNDIS_STATUS Status,
  PNDIS_HANDLE ConfigurationHandle,
  PNDIS_STRING ProtocolSection
);

Status
[out] Pointer to a caller-supplied variable that is set to NDIS_STATUS_SUCCESS or NDIS_STATUS_FAILURE on return from this function.

ConfigurationHandle
[out] Pointer to a caller-supplied variable in which this function returns the handle to the registry key for the named driver to which the caller will bind itself later. Value entries under this key contain protocol-installed, adapter-specific information.

ProtocolSection
[in] Pointer to a counted string specified in the system-default character set, naming the NDIS driver, effectively the adapter, for which the **Parms\**ProtocolName key in the registry protocol section should be opened.

For NDIS drivers that have a ProtocolBindAdapter function, this pointer is the SystemSpecific1 input parameter of that function.

The following table shows the return values for the status of this function.

Value	Description
NDIS_STATUS_SUCCESS	The handle at ConfigurationHandle.
NDIS_STATUS_FAILURE	NDIS could not assign a handle.

Header	ndis.h
Windows Embedded CE	Windows CE .NET 4.0 and later