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
値エントリのクエリに最初に使用されるキーのハンドル。 このハンドルは、ZwCreateKeyまたは ZwOpenKey正常に呼び出すことによって作成されます。
[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 |
関連項目
ドライバー でのレジストリの使用の