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

값을 받는 유니코드 문자열에 대한 포인터입니다. 호출이 성공하면 입니다. 문자열이 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