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

另请参阅

STATE_LOCATION_TYPE