GetCurrentPackageInfo2 함수(appmodel.h)

아티클
02/26/2024

패키지에 대해 검색할 폴더 경로의 유형을 지정하는 옵션을 사용하여 호출 프로세스에 대한 패키지 정보를 가져옵니다.

구문

LONG GetCurrentPackageInfo2(
  const UINT32    flags,
  PackagePathType packagePathType,
  UINT32          *bufferLength,
  BYTE            *buffer,
  UINT32          *count
);

매개 변수

flags

형식: const UINT32

패키지 정보를 검색하는 방법을 지정하는 패키지 상수 입니다. PACKAGE_FILTER_* 플래그가 지원됩니다.

packagePathType

형식: PackagePathType

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

bufferLength

형식: UINT32*

입력에서 버퍼 크기(바이트)입니다. 출력에서 반환된 구조체 배열의 크기(바이트)입니다.

buffer

형식: BYTE*

PACKAGE_INFO 구조체의 배열로 표현되는 패키지 정보입니다.

count

형식: UINT32*

버퍼의 구조체 수입니다.

반환 값

형식: LONG

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

반환 코드	설명
APPMODEL_ERROR_NO_PACKAGE	프로세스에 패키지 ID가 없습니다.
ERROR_INSUFFICIENT_BUFFER	버퍼가 데이터를 저장할 만큼 크지 않습니다. 필요한 크기는 bufferLength로 지정됩니다.

설명

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

요구 사항

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