RtlGetPersistedStateLocation 函数 (ntddk.h)
从重定向映射中检索指定 SourceID 的重定向位置。
语法
NTSYSAPI NTSTATUS RtlGetPersistedStateLocation(
[_In_] PCWSTR SourceID,
[_In_opt_] PCWSTR CustomValue,
[_In_opt_] PCWSTR DefaultPath,
[_In_] STATE_LOCATION_TYPE StateLocationType,
[_In_] PWCHAR TargetPath,
[_In_] ULONG BufferLengthIn,
[_Out_opt_] PULONG BufferLengthOut
);
参数
[_In_] SourceID
重定向映射中要查找的标识符。
[_In_opt_] CustomValue
自选。 要检索的值(如果该值不同于默认值)。
[_In_opt_] DefaultPath
自选。 如果在映射中找不到 SourceID 值的条目,则返回此值。
[_In_] StateLocationType
指示要查找的状态类型的 STATE_LOCATION_TYPE-type 值;注册表或文件系统。
[_In_] TargetPath
指向接收值的 Unicode 字符串的指针。 如果调用成功。 字符串以 null 结尾。
[_In_] BufferLengthIn
TargetPath所指向的字符串的大小(以字节为单位)。
[_Out_opt_] BufferLengthOut
自选。 如果指定,则返回写入缓冲区的字节数,以防调用成功;如果调用失败并出现STATUS_BUFFER_OVERFLOW错误代码,则需要的字节数。
返回值
返回一个 NTSTATUS 值,该值指示作失败的成功。 否则,返回适当的NTSTATUS 值。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 10 版本 1803 |
标头 | ntddk.h |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |