RtlQueryRegistryValueWithFallback 函式 (ntddk.h)

使用 主要句柄來擷取登錄機碼的值專案;如果找不到,請使用後援句柄。

語法

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
);

參數

[in] PrimaryHandle

第一次用來查詢值專案的索引鍵句柄。 此句柄是由成功呼叫 ZwCreateKeyZwOpenKey 所建立。

[in] FallbackHandle

如果使用 PrimaryHandle 指定的句柄找不到值,則用來查詢索引鍵的句柄。

[in] ValueName

字串的指標,其中包含要擷取數據之值的名稱。

[in] ValueLength

指定 ValueName 字串的大小,以位元組為單位。

[Out] ValueType

ULONG 變數的指標,可接收所查詢之值的型別。

[out] ValueData

接收值數據的緩衝區指標。

[out] ResultLength

以位元組為單位接收值數據大小的變數指標。 如果傳回值STATUS_SUCCESS,表示寫入 ValueData 緩衝區的位元元組數目。 如果呼叫傳回STATUS_BUFFER_OVERFLOW,表示所需的位元元組數目。 呼叫端可以使用該值來判斷保存數據資訊所需的 ValueData 緩衝區大小。

傳回值

傳回成功時STATUS_SUCCESS,或在失敗時傳回適當的錯誤碼。

規格需求

需求
最低支援的用戶端 Windows 10 版本 1809
標頭 ntddk.h (包含 wdm.h)
程式庫 NtosKrnl.lib
IRQL PASSIVE_LEVEL

另請參閱

在驅動程式中使用登錄