Função NdisOpenConfigurationKeyByIndex (ndis.h)

Artigo
08/07/2023

A função NdisOpenConfigurationKeyByIndex abre uma subchave de uma determinada chave do Registro aberta designada por um identificador fornecido pelo chamador.

Sintaxe

void NdisOpenConfigurationKeyByIndex(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  ULONG        Index,
  [out] PNDIS_STRING KeyName,
  [out] PNDIS_HANDLE KeyHandle
);

Parâmetros

[out] Status

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

NDIS_STATUS_SUCCESS

O NDIS inicializou o acesso à subchave especificada por KeyName e Index .

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] Index

O índice da subchave a ser aberta. Esse valor baseado em zero designa a subchave a ser aberta sob a chave já aberta com ConfigurationHandle .

[out] KeyName

Um ponteiro para um tipo de NDIS_STRING que contém um buffer fornecido pelo chamador no qual essas funções retornam uma cadeia de caracteres contada no conjunto de caracteres padrão do sistema. Essa cadeia de caracteres especifica o nome da subchave aberta se a chamada for bem-sucedida. 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] KeyHandle

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

Retornar valor

Nenhum

Comentários

NdisOpenConfigurationKeyByIndex permite que um driver acesse informações de configuração que seu arquivo de instalação armazenou em uma subchave do Registro.

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

Como NdisOpenConfigurationKeyByIndex faz referência a uma subchave por meio de um índice, o driver não precisa especificar nomes de subchave. Um driver pode sequenciar por meio de um conjunto de subchaves do Registro chamando repetidamente NdisOpenConfigurationKeyIndex depois de incrementar o índice até que a função retorne NDIS_STATUS_FAILURE, indicando assim que não há mais subchaves para abrir.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisOpenConfigurationKeyByIndex (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisOpenConfigurationKeyByIndex (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 da DDI	Irql_Miscellaneous_Function(ndis)