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

Статья
02/29/2024

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

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