GetPackagePathByFullName2 함수(appmodel.h)

  • 아티클

패키지에 대해 검색할 폴더 경로의 형식을 지정하는 옵션을 사용하여 지정된 패키지의 경로를 가져옵니다.

구문

LONG GetPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

매개 변수

packageFullName

형식: PCWSTR

패키지의 전체 이름입니다.

packagePathType

형식: PackagePathType

패키지(원래 설치 폴더 또는 변경 가능한 폴더)에 대해 검색할 폴더 경로의 유형을 나타냅니다.

pathLength

형식: UINT32*

null 종결자를 포함하는 패키지 경로 문자열의 문자 수(WCHAR)를 보유하는 변수에 대한 포인터입니다.

먼저 NULL 을 경로 에 전달하여 문자 수를 가져옵니다. 이 숫자를 사용하여 경로에 대한 메모리 공간을 할당합니다. 그런 다음 이 메모리 공간의 주소를 전달하여 경로를 채웁니다.

path

형식: PWSTR

null 종결자를 포함하는 패키지 경로 문자열을 수신하는 메모리 공간에 대한 포인터입니다.

반환 값

형식: LONG

함수가 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 함수는 오류 코드를 반환합니다. 가능한 오류 코드에는 다음이 포함됩니다.

반환 코드 설명
ERROR_INSUFFICIENT_BUFFER
 경로로 지정된 버퍼가 데이터를 저장할 만큼 크지 않습니다. 필요한 크기는 pathLength로 지정됩니다.

설명

packagePathType 매개 변수는 패키지 매니페스트에서 windows.mutablePackageDirectories 확장을 사용하는 애플리케이션에 유용합니다. 이 확장은 사용자가 설치 파일을 수정할 수 있도록 애플리케이션 설치 폴더의 내용이 프로젝션되는 %ProgramFiles%\ModifiableWindowsApps 경로 아래의 폴더를 지정합니다. 이 기능은 현재 Microsoft 및 파트너가 게시한 특정 유형의 데스크톱 PC 게임에만 사용할 수 있으며 이러한 유형의 게임에서 모드를 지원할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 appmodel.h
라이브러리 Kernel32.lib
DLL KernelBase.dll

추가 정보

GetPackagePathByFullName