Função NdisOpenConfigurationKeyByName (ndis.h)

A função NdisOpenConfigurationKeyByName abre uma subchave nomeada de uma determinada chave de registro aberta designada por um identificador fornecido pelo chamador.

Sintaxe

void NdisOpenConfigurationKeyByName(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  PNDIS_STRING SubKeyName,
  [out] PNDIS_HANDLE SubKeyHandle
);

Parâmetros

[out] Status

Um ponteiro para uma variável fornecida pelo chamador na qual essa função retorna o status de sua tentativa de abrir a chave do Registro. Os possíveis valores retornados são um dos seguintes:

NDIS_STATUS_SUCCESS

O NDIS inicializou o acesso à subchave especificada por SubKeyName .

NDIS_STATUS_FAILURE

Não foi possível abrir a chave.

[in] ConfigurationHandle

O identificador para uma chave do Registro para a qual uma subchave deve ser aberta. Normalmente, ConfigurationHandle é retornado pelo Função NdisOpenConfigurationEx .

[in] SubKeyName

Um ponteiro para um tipo de NDIS_STRING que contém uma cadeia de caracteres contada fornecida pelo chamador no conjunto de caracteres padrão do sistema que especifica o nome da subchave do Registro a ser aberta. Para drivers do Microsoft Windows 2000 e posteriores, essa cadeia de caracteres contém caracteres Unicode. Ou seja, para o Windows 2000 e posterior, o NDIS define o tipo NDIS_STRING como um tipo de UNICODE_STRING .

[out] SubKeyHandle

Um ponteiro para uma variável fornecida pelo chamador na qual essa função retorna um identificador para a subchave aberta se essa chamada for bem-sucedida.

Retornar valor

Nenhum

Comentários

NdisOpenConfigurationKeyByName permite que um driver acesse informações de configuração armazenadas em uma subchave nomeada no registro.

Observe que o ConfigurationHandle passado para NdisOpenConfigurationKeyByName pode ser qualquer identificador válido para uma chave do Registro já aberta pelo chamador. NdisOpenConfigurationKeyByName retorna informações de configuração para subchaves relativas a qualquer ConfigurationHandle válido.

Depois que um driver tiver consumido e, possivelmente, modificado as informações de configuração do Registro, ele deverá chamar a função NdisCloseConfiguration para liberar o identificador obtido de NdisOpenConfigurationKeyByName. O NdisCloseConfiguration também libera qualquer armazenamento temporário alocado no NDIS nas chamadas do driver para as funções NdisReadConfiguration, NdisReadNetworkAddress ou NdisWriteConfiguration com o SubKeyHandle retornado por NdisOpenConfigurationKeyByName .

Requisitos

Confira também

ANSI_STRING

MiniportInitializeEx

NdisCloseConfiguration

NdisOpenConfigurationEx

NdisReadConfiguration

NdisWriteConfiguration

ProtocolBindAdapterEx

UNICODE_STRING