Função NdisOpenConfigurationKeyByName (ndis.h)
A função NdisOpenConfigurationKeyByName abre uma subchave nomeada de uma determinada chave de registro aberta que é 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 valores retornados possíveis são um dos seguintes:
NDIS_STATUS_SUCCESS
O NDIS foi inicializado acessado à subchave especificada pelo 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 de 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.
Valor de retorno
Nenhum
Observações
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. NdisCloseConfiguration também libera qualquer armazenamento temporário alocado pelo NDIS nas chamadas do driver para o NdisReadConfiguration, NdisReadNetworkAdd Funçõesou NdisWriteConfiguration com o SubKeyHandle que NdisOpenConfigurationKeyByName retornados.