|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 writes a caller-supplied value for a specified entry into the registry.
VOID NdisWriteConfiguration( OUT PNDIS_STATUS Status , IN NDIS_HANDLE WrapperConfigurationContext , IN PNDIS_STRING Keyword , IN PNDIS_CONFIGURATION_PARAMETER * ParameterValue );
|NDIS_STATUS_SUCCESS||The supplied value at ParameterValuewas written into the registry. If this is a new entry, the name at Keywordwas also written into the registry.|
|NDIS_STATUS_NOT_SUPPORTED||The supplied ParameterTypeis invalid.|
|NDIS_STATUS_RESOURCES||NDIS could not allocate resources, usually enough memory, to transfer the requested information to the registry.|
|NDIS_STATUS_FAILURE||The requested information could not be written.|
If an entry of the same name as at Keywordalready exists under the opened registry key, this function replaces its current value with the caller-supplied value. Otherwise, this function adds a new value entry with the specified name and supplied value to the registry.
This function buffers and copies the caller-supplied string at Keywordand the caller-supplied data specified at ParameterValue. This memory is freed when the driver releases the ConfigurationHandlewith the NdisCloseConfigurationfunction. The caller of this function is responsible for releasing the buffered string at Keywordand the memory allocated for the NDIS_CONFIGURATION_PARAMETERstructure.
As an alternative to calling this function, every NDIS driver can set up configuration information in the registry for itself under the driver's Parameterskey, using an installation script.
A driver that calls this function runs at IRQL PASSIVE_LEVEL.
|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.
NdisAnsiStringToUnicodeString, NdisCloseConfiguration, NdisFreeMemory, NdisFreeString, NdisInitAnsiString, NdisInitializeString, NdisInitUnicodeString, NdisOpenConfiguration, NdisOpenProtocolConfiguration, NdisReadConfiguration, NdisUnicodeStringToAnsiString
Last updated on Tuesday, July 13, 2004