RtlGetPersistedStateLocation - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
#ifndef _NTRTL_H
#if (PHNT_VERSION >= PHNT_WINDOWS_10_RS3)

// private
NTSYSAPI
NTSTATUS
NTAPI
RtlGetPersistedStateLocation(
    _In_ PCWSTR SourceID,
    _In_opt_ PCWSTR CustomValue,
    _In_opt_ PCWSTR DefaultPath,
    _In_ STATE_LOCATION_TYPE StateLocationType,
    _Out_writes_bytes_to_opt_(BufferLengthIn, *BufferLengthOut) PWCHAR TargetPath,
    _In_ ULONG BufferLengthIn,
    _Out_opt_ PULONG BufferLengthOut
    );

#endif
#endif

View code on GitHub
// ntddk.h

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
);
View the official Windows Driver Kit DDI reference

NtDoc

This function is documented in Windows Driver Kit.

Edit description on GitHub

Windows Driver Kit DDI reference (nf-ntddk-rtlgetpersistedstatelocation)

RtlGetPersistedStateLocation function

Description

Retrieves the redirected location for the specified SourceID from the redirection map.

Parameters

SourceID [_In_]

The identifier to lookup in the redirection map.

CustomValue [_In_opt_]

Optional. The value to retrieve, if it's different than the default value.

DefaultPath [_In_opt_]

Optional. If an entry for the SourceID value cannot be found in the map, returns this value.

StateLocationType [_In_]

A STATE_LOCATION_TYPE-type value that indicates the type of State to look up; registry or file system.

TargetPath [_In_]

A pointer to a Unicode string that receives the value. If the call is successful. The string is null-terminated.

BufferLengthIn [_In_]

The size of the string pointed to by _TargetPath_, in bytes.

BufferLengthOut [_Out_opt_]

Optional. If specified, returns the number of bytes written to the buffer in case the call is successful; number of bytes required if the call fails with the STATUS_BUFFER_OVERFLOW error code.

Return value

Returns an NTSTATUS value that indicates the success of failure of the operation. Otherwise returns an appropriate NTSTATUS value.

Remarks

See also

STATE_LOCATION_TYPE

View the official Windows Driver Kit DDI reference

Edit description on GitHub