Função NdisOpenConfigurationKeyByIndex (ndis.h)
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) |