PackageFamilyNameFromId 関数 (appmodel.h)
指定したパッケージ識別子のパッケージ ファミリ名を取得します。
構文
LONG PackageFamilyNameFromId(
[in] const PACKAGE_ID *packageId,
[in, out] UINT32 *packageFamilyNameLength,
[out, optional] PWSTR packageFamilyName
);
パラメーター
[in] packageId
型: const PACKAGE_ID*
パッケージ ID。
[in, out] packageFamilyNameLength
種類: UINT32*
入力時の packageFamilyName バッファーのサイズ (文字数)。 出力時に返されるパッケージ ファミリ名のサイズ (null 終端記号を含む文字単位)。
[out, optional] packageFamilyName
種類: PWSTR
パッケージ ファミリ名。
戻り値
型: LONG
関数が成功した場合は 、ERROR_SUCCESSを返します。 それ以外の場合、関数はエラー コードを返します。 考えられるエラー コードは次のとおりです。
| リターン コード | 説明 |
|---|---|
|
バッファーは、データを保持するのに十分な大きさではありません。 必要なサイズは packageFamilyNameLength によって指定されます。 |
注釈
文字列サイズの制限については、「 ID 定数」を参照してください。
例
#define _UNICODE 1
#define UNICODE 1
#include <Windows.h>
#include <appmodel.h>
#include <malloc.h>
#include <stdlib.h>
#include <errno.h>
#include <stdio.h>
int ShowUsage();
bool ParseArchitecture(__in PCWSTR architectureString, __out UINT32 * architecture);
bool ParseVersion(__in PCWSTR versionString, __out PACKAGE_VERSION * version);
int ShowUsage()
{
wprintf(L"Usage: PackageFamilyNameFromId <name><version> <arch> <resourceid> <publisher>\n");
return 1;
}
int __cdecl wmain(__in int argc, __in_ecount(argc) WCHAR * argv[])
{
if (argc <= 5)
return ShowUsage();
PACKAGE_ID packageId;
ZeroMemory(&packageId, sizeof(packageId));
packageId.name = argv[1];
if (!ParseVersion(argv[2], &packageId.version))
return 2;
if (!ParseArchitecture(argv[3], &packageId.processorArchitecture))
return 3;
packageId.resourceId = argv[4];
packageId.publisher = argv[5];
UINT32 length = 0;
LONG rc = PackageFamilyNameFromId(&packageId, &length, NULL);
if (rc == ERROR_SUCCESS)
{
wprintf(L"PackageFamilyNameFromId unexpected succeeded\n");
return 4;
}
else if (rc != ERROR_INSUFFICIENT_BUFFER)
{
wprintf(L"Error %d in PackageFamilyNameFromId\n", rc);
return 5;
}
PWSTR familyName = (PWSTR) malloc(length * sizeof(WCHAR));
if (familyName == NULL)
{
wprintf(L"Error allocating memory\n");
return 6;
}
rc = PackageFamilyNameFromId(&packageId, &length, familyName);
if (rc != ERROR_SUCCESS)
wprintf(L"Error %d converting Package Id to Family Name\n", rc);
else
wprintf(L"Package Family Name = %s\n", familyName);
free(familyName);
return rc == ERROR_SUCCESS ? 0 : 7;
}
bool ParseArchitecture(__in PCWSTR architectureString, __out UINT32 * architecture)
{
if (_wcsicmp(architectureString, L"neutral") == 0)
*architecture = PROCESSOR_ARCHITECTURE_NEUTRAL;
else if (_wcsicmp(architectureString, L"x86") == 0)
*architecture = PROCESSOR_ARCHITECTURE_INTEL;
else if (_wcsicmp(architectureString, L"x64") == 0)
*architecture = PROCESSOR_ARCHITECTURE_AMD64;
else if (_wcsicmp(architectureString, L"arm") == 0)
*architecture = PROCESSOR_ARCHITECTURE_ARM;
else
{
wprintf(L"Invalid architecture\n");
return false;
}
return true;
}
bool ParseVersion(__in PCWSTR versionString, __out PACKAGE_VERSION * version)
{
PWSTR s = (PWSTR) versionString;
ULONG n = wcstoul(s, &s, 10);
if (((n == 0) || (n > 65535)) && (errno == ERANGE)) {
wprintf(L"Invalid Version (Major)\n");
return false;
}
version->Major = (USHORT) n;
if (*s != L'.')
{
wprintf(L"Invalid Version\n");
return false;
}
n = wcstoul(++s, &s, 10);
if (((n == 0) || (n > 65535)) && (errno == ERANGE)) {
wprintf(L"Invalid Version (Minor)\n");
return false;
}
version->Minor = (USHORT) n;
if (*s != L'.')
{
wprintf(L"Invalid Version\n");
return false;
}
n = wcstoul(++s, &s, 10);
if (((n == 0) || (n > 65535)) && (errno == ERANGE)) {
wprintf(L"Invalid Version (Build)\n");
return false;
}
version->Build = (USHORT) n;
if (*s != L'.')
{
wprintf(L"Invalid Version\n");
return false;
}
n = wcstoul(++s, &s, 10);
if (((n == 0) || (n > 65535)) && (errno == ERANGE)) {
wprintf(L"Invalid Version (Revision)\n");
return false;
}
version->Revision = (USHORT) n;
return true;
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | appmodel.h |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |