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を返します。 それ以外の場合、関数はエラー コードを返します。 考えられるエラー コードは次のとおりです。

リターン コード 説明
ERROR_INSUFFICIENT_BUFFER
 path で指定されたバッファーは、データを保持するのに十分な大きさではありません。 必要なサイズは pathLength で指定します。

注釈

packagePathType パラメーターは、パッケージ マニフェストで windows.mutablePackageDirectories 拡張機能を使用するアプリケーションに役立ちます。 この拡張機能は、%ProgramFiles%\ModifiableWindowsApps パスの下にあるフォルダーを指定します。このパスでは、ユーザーがインストール ファイルを変更できるように、アプリケーションのインストール フォルダーの内容が投影されます。 この機能は現在、Microsoft とパートナーによって公開されている特定の種類のデスクトップ PC ゲームでのみ使用でき、これらの種類のゲームで MOD をサポートできます。

要件

要件 値
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー appmodel.h
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

GetStagedPackagePathByFullName