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 |