GetCurrentApplicationUserModelId 関数 (appmodel.h)
現在のプロセスの アプリケーション ユーザー モデル ID を 取得します。
構文
LONG GetCurrentApplicationUserModelId(
[in, out] UINT32 *applicationUserModelIdLength,
[out] PWSTR applicationUserModelId
);
パラメーター
[in, out] applicationUserModelIdLength
入力時の applicationUserModelId バッファーのサイズ (ワイド文字)。 成功した場合は、null ターミネータを含め、使用されるバッファーのサイズ。
[out] applicationUserModelId
アプリケーション ユーザー モデル ID を受け取るバッファーへのポインター。
戻り値
関数が成功すると、 ERROR_SUCCESSが返されます。 それ以外の場合、関数はエラー コードを返します。 考えられるエラー コードは次のとおりです。
リターン コード | 説明 |
---|---|
|
このプロセスにはアプリケーション ID がありません。 |
|
バッファーは、データを保持するのに十分な大きさではありません。 必要なサイズは、 applicationUserModelIdLength によって指定されます。 |
注釈
文字列サイズの制限については、「 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 = GetCurrentApplicationUserModelId(&length, NULL);
if (rc != ERROR_INSUFFICIENT_BUFFER)
{
if (rc == APPMODEL_ERROR_NO_APPLICATION)
wprintf(L"Desktop application\n");
else
wprintf(L"Error %d in GetCurrentApplicationUserModelId\n", rc);
return 1;
}
PWSTR fullName = (PWSTR) malloc(length * sizeof(*fullName));
if (fullName == NULL)
{
wprintf(L"Error allocating memory\n");
return 2;
}
rc = GetCurrentApplicationUserModelId(&length, fullName);
if (rc != ERROR_SUCCESS)
{
wprintf(L"Error %d retrieving ApplicationUserModelId\n", rc);
return 3;
}
wprintf(L"%s\n", fullName);
free(fullName);
return 0;
}
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | appmodel.h |
Library | Kernel32.lib |
[DLL] | Kernel32.dll |