Função RtlQueryRegistryValueWithFallback (ntddk.h)
Recupera uma entrada de valor para uma chave do Registro usando um identificador primário; se não for encontrado, usará o identificador de fallback.
Sintaxe
NTSYSAPI NTSTATUS RtlQueryRegistryValueWithFallback(
[in] HANDLE PrimaryHandle,
[in] HANDLE FallbackHandle,
[in] PUNICODE_STRING ValueName,
[in] ULONG ValueLength,
[Out] PULONG ValueType,
[out] PVOID ValueData,
[out] PULONG ResultLength
);
Parâmetros
[in] PrimaryHandle
O identificador para a chave que é usada pela primeira vez para consultar as entradas de valor. Esse identificador é criado por uma chamada bem-sucedida para ZwCreateKey ou ZwOpenKey.
[in] FallbackHandle
O identificador a ser usado para consultar a chave se o valor não for encontrado usando o identificador especificado por PrimaryHandle.
[in] ValueName
Um ponteiro para a cadeia de caracteres que contém o nome do valor para o qual recuperar dados.
[in] ValueLength
Especifica o tamanho, em bytes, da cadeia de caracteres ValueName.
[Out] ValueType
Um ponteiro para uma variável ULONG que recebe o tipo do valor que está sendo consultado.
[out] ValueData
Um ponteiro para um buffer que recebe os dados de valor.
[out] ResultLength
Um ponteiro para uma variável que recebe o tamanho dos dados de valor, em bytes. Se o valor retornado for STATUS_SUCCESS, indicará o número de bytes gravados no buffer ValueData. Se a chamada retornar STATUS_BUFFER_OVERFLOW, indicará o número de bytes necessários. Os chamadores podem usar esse valor para determinar o tamanho de buffer ValueData necessário para armazenar as informações de dados.
Valor de retorno
Retorna STATUS_SUCCESS com êxito ou o código de erro apropriado sobre falha.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1809 |
| cabeçalho | ntddk.h (include wdm.h) |
| biblioteca | NtosKrnl.lib |
| IRQL | PASSIVE_LEVEL |