GetPackageId 함수(appmodel.h)

지정된 프로세스의 패키지 식별자(ID)를 가져옵니다.

구문

LONG GetPackageId(
  [in]            HANDLE hProcess,
  [in, out]       UINT32 *bufferLength,
  [out, optional] BYTE   *buffer
);

매개 변수

[in] hProcess

형식: HANDLE

PROCESS_QUERY_INFORMATION 또는PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있는 프로세스에 대한 핸들입니다. 자세한 내용은 프로세스 보안 및 액세스 권한을 참조하세요.

[in, out] bufferLength

형식: UINT32*

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

[out, optional] buffer

형식: BYTE*

PACKAGE_ID 구조체로 표현되는 패키지 ID입니다.

반환 값

형식: LONG

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

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

요구 사항

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

참고 항목

GetCurrentPackageId

GetPackageFamilyName

GetPackageFullName