GetCurrentPackageFullName 함수(appmodel.h)
호출 프로세스의 패키지 전체 이름을 가져옵니다.
구문
LONG GetCurrentPackageFullName(
[in, out] UINT32 *packageFullNameLength,
[out, optional] PWSTR packageFullName
);
매개 변수
[in, out] packageFullNameLength
형식: UINT32*
입력에서 packageFullName 버퍼의 크기(문자)입니다. 출력에서 null 종결자를 포함하여 반환된 패키지 전체 이름의 크기(문자)입니다.
[out, optional] packageFullName
형식: PWSTR
패키지 전체 이름입니다.
반환 값
형식: LONG
함수가 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 함수는 오류 코드를 반환합니다. 가능한 오류 코드에는 다음이 포함됩니다.
반환 코드 | 설명 |
---|---|
|
프로세스에 패키지 ID가 없습니다. |
|
버퍼가 데이터를 저장할 만큼 크지 않습니다. 필요한 크기는 packageFullNameLength로 지정됩니다. |
설명
문자열 크기 제한에 대한 자세한 내용은 ID 상수를 참조하세요.
예제
#define _UNICODE 1
#define UNICODE 1
#include <Windows.h>
#include <appmodel.h>
#include <malloc.h>
#include <stdio.h>
int __cdecl wmain()
{
UINT32 length = 0;
LONG rc = GetCurrentPackageFullName(&length, NULL);
if (rc != ERROR_INSUFFICIENT_BUFFER)
{
if (rc == APPMODEL_ERROR_NO_PACKAGE)
wprintf(L"Process has no package identity\n");
else
wprintf(L"Error %d in GetCurrentPackageFullName\n", rc);
return 1;
}
PWSTR fullName = (PWSTR) malloc(length * sizeof(*fullName));
if (fullName == NULL)
{
wprintf(L"Error allocating memory\n");
return 2;
}
rc = GetCurrentPackageFullName(&length, fullName);
if (rc != ERROR_SUCCESS)
{
wprintf(L"Error %d retrieving PackageFullName\n", rc);
return 3;
}
wprintf(L"%s\n", fullName);
free(fullName);
return 0;
}
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | appmodel.h |
라이브러리 | Kernel32.lib |
DLL | Kernel32.dll |