Share via


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