NdisOpenProtocolConfiguration

This function returns a handle for the HKEY_LOCAL_MACHINE\Comm\ProtocolName\Parms registry 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\**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.

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

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

© 1992-2000 Microsoft Corporation. All rights reserved.