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类型值;注册表或文件系统。
[_In_] TargetPath
指向接收值的 Unicode 字符串的指针。 如果调用成功。 字符串以 null 结尾。
[_In_] BufferLengthIn
TargetPath 指向的字符串的大小(以字节为单位)。
[_Out_opt_] BufferLengthOut
可选。 如果指定,则返回写入缓冲区的字节数,以防调用成功;如果调用失败并出现错误代码,则所需的字节数STATUS_BUFFER_OVERFLOW。
返回值
返回一个 NTSTATUS 值,该值指示操作成功失败。 否则返回相应的 NTSTATUS 值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 1803 |
标头 | ntddk.h |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |