Функция 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. В противном случае функция возвращает код ошибки. Возможные коды ошибок включают следующие.
Код возврата | Описание |
---|---|
|
Процесс не имеет удостоверения пакета. |
|
Буфер недостаточно велик для хранения данных. Требуемый размер задается параметром packageFullNameLength. |
Комментарии
Сведения об ограничениях размера строк см. в разделе Константы удостоверений.
Примеры
#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 |
Header | appmodel.h |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |