NdisWriteConfiguration

9/8/2008

Essa função grava um valor para uma entrada especificada para o Registro Caller-supplied.

Syntax

VOID NdisWriteConfiguration(
  PNDIS_STATUS Status,
  NDIS_HANDLE ConfigurationHandle,
  PNDIS_STRING Keyword,
  PNDIS_CONFIGURATION_PARAMETER ParameterValue
);

Parameters

• Status
  [out] Ponteiro para uma variável Caller-supplied que indica o status do chamar.

• ConfigurationHandle
  [no] Especifica o identificador retornado pela NdisOpenConfiguration ou o NdisOpenProtocolConfiguration função.

• Palavra-chave
  [no] Ponteiro para um chamador-fornecido contados seqüência de caracteres, no sistema-conjunto de caracteres usar como padrão, especificando o nome de uma entrada para o qual gravar o valor.

• ParameterValue
  [no] Aponta para uma variável Caller-supplied definido como o endereço de uma filled-in NDIS_CONFIGURATION_PARAMETER estrutura.

Return Value

A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
NDIS_STATUS_SUCCESS	O valor fornecido no ParameterValue foi escrito para o Registro. Se esta for uma nova entrada, o nome no Palavra-chave Também foi escrito para o Registro.
NDIS_STATUS_NOT_SUPPORTED	O fornecido ParameterType é inválido.
NDIS_STATUS_RESOURCES	NDIS não pôde alocar recursos, geralmente suficiente memória, para transferir as informações solicitadas para o Registro.
NDIS_STATUS_FAILURE	Não foi possível gravar as informações solicitadas.

Remarks

Se uma entrada com o mesmo nome como em Palavra-chave Já existe sob a chave Registro aberto, essa função substitui sua atual valor com o valor Caller-supplied. Caso contrário, essa função adiciona uma nova entrada valor com o nome especificado e fornecido valor para o Registro.

Essa função buffers e copia o seqüência de caracteres Caller-supplied no Palavra-chave e os dados Caller-supplied especificado no ParameterValue. Essa memória é liberada quando o driver libera o ConfigurationHandle Com o NdisCloseConfiguration função. O chamador desta função é responsável por liberando a armazenada em buffer seqüência de caracteres no Palavra-chave e a memória alocada para o NDIS_CONFIGURATION_PARAMETER estrutura.

Como um alternativo para chamado essa função, cada driver NDIS pode configurar configuração informações no Registro para si mesmo sob do o driver Parâmetros chave, usando um script instalação.

Requirements

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

See Also

Reference

NdisAnsiStringToUnicodeString
NdisCloseConfiguration
NdisFreeMemory
NdisFreeString
NdisInitAnsiString
NdisInitializeString
NdisInitUnicodeString
NdisOpenConfiguration
NdisOpenProtocolConfiguration
NdisReadConfiguration
NdisUnicodeStringToAnsiString