GetStagedPackagePathByFullName2 関数 (appmodel.h)
指定したステージング パッケージのパスを取得します。オプションを使用して、パッケージに対して取得するフォルダー パスの種類を指定します。
構文
LONG GetStagedPackagePathByFullName2(
PCWSTR packageFullName,
PackagePathType packagePathType,
UINT32 *pathLength,
PWSTR path
);
パラメーター
packageFullName
種類: PCWSTR
ステージング されたパッケージの完全な名前。
packagePathType
種類: PackagePathType
パッケージ (元のインストール フォルダーまたは変更可能なフォルダー) に対して取得するフォルダー パスの種類を示します。
pathLength
種類: UINT32*
パッケージ パス文字列内の文字数 (WCHAR) を保持する変数へのポインター。これには null 終端記号が含まれます。
まず、パスにNULL を渡して文字数を取得します。 この番号を使用して 、パスのメモリ領域を割り当てます。 次に、このメモリ領域のアドレスをパスに渡 します。
path
種類: PWSTR
null 終端記号を含むパッケージ パス文字列を受け取るメモリ領域へのポインター。
戻り値
型: LONG
関数が成功した場合は 、ERROR_SUCCESSを返します。 それ以外の場合、関数はエラー コードを返します。 考えられるエラー コードは次のとおりです。
リターン コード | 説明 |
---|---|
|
path で指定されたバッファーは、データを保持するのに十分な大きさではありません。 必要なサイズは pathLength で指定します。 |
注釈
packagePathType パラメーターは、パッケージ マニフェストで windows.mutablePackageDirectories 拡張機能を使用するアプリケーションに役立ちます。 この拡張機能は、%ProgramFiles%\ModifiableWindowsApps パスの下にあるフォルダーを指定します。このパスでは、ユーザーがインストール ファイルを変更できるように、アプリケーションのインストール フォルダーの内容が投影されます。 この機能は現在、Microsoft とパートナーによって公開されている特定の種類のデスクトップ PC ゲームでのみ使用でき、これらの種類のゲームで MOD をサポートできます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | appmodel.h |
Library | Kernel32.lib |
[DLL] | Kernel32.dll |