Função NdisOpenConfigurationKeyByIndex (ndis.h)
A função NdisOpenConfigurationKeyByIndex abre uma subchave de uma determinada chave aberta do Registro 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 o 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 foi inicializado acessado à subchave especificada por KeyName e Index .
NDIS_STATUS_FAILURE
Não foi possível abrir a chave.
[in] ConfigurationHandle
O identificador de 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 de NDIS_STRING como um tipo de UNICODE_STRING.
[out] KeyHandle
Um ponteiro para uma variável fornecida pelo chamador na qual essa função retorna um identificador para a subchave aberta se a chamada for bem-sucedida.
Valor de retorno
Nenhum
Observações
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 chave válida
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 que não há mais subchaves a serem abertas.
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. NdisCloseConfiguration também libera qualquer armazenamento temporário alocado pelo NDIS para as chamadas do driver para o NdisReadConfiguration , NdisReadNetworkAdd FunçõesNdisWriteConfiguration ou com o subKeyHandle que NdisOpenConfigurationKeyByIndex retornados.