Функция RtlGetPersistedStateLocation (ntddk.h)

Статья
02/07/2025

Извлекает перенаправленное расположение для указанного 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

Указатель на строку Юникода, которая получает значение. Если вызов выполнен успешно. Строка завершается значением 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

Поделиться через