Função NdisOpenConfigurationKeyByName (ndis.h)

Artigo
08/07/2023

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

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisOpenConfigurationKeyByName (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisOpenConfigurationKeyByName (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	< DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_Miscellaneous_Function(ndis)