Microsoft Windows CE 3.0  

NdisOpenProtocolConfiguration

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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.