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

另请参阅

STATE_LOCATION_TYPE