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

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

Parameters

Status

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

ConfigurationHandle

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

Pointer to a counted string, specified in the system-default character set, naming the NDIS driver, effectively the adapter, for which the Parameters\ ProtocolNamekey in the registry protocol section should be opened.

For NDIS drivers that have a ProtocolBindAdapterfunction, this pointer is the SystemSpecific1input parameter of that function.

Remarks

Currently, the Windows CE version of this function is a stub that exists to make existing code compile without error; it does no actual work. Current protocol stack implementations for Windows CE have their own means for obtaining configuration information. If that changes in later releases of Windows CE, this function may be developed more fully.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Ndis.h

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

---

 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.