GetPackagesByPackageFamily 関数 (appmodel.h)

現在のユーザーの指定したファミリ名を持つパッケージを取得します。

構文

LONG GetPackagesByPackageFamily(
  [in]            PCWSTR packageFamilyName,
  [in, out]       UINT32 *count,
  [out, optional] PWSTR  *packageFullNames,
  [in, out]       UINT32 *bufferLength,
  [out, optional] WCHAR  *buffer
);

パラメーター

[in] packageFamilyName

種類: PCWSTR

パッケージ ファミリ名。

[in, out] count

型: UINT32*

パッケージの完全名の数を保持する変数へのポインター。

まず、packageFullNames に NULL を渡して、パッケージの完全な名前の数を取得します。 packageFullNames のメモリ領域を割り当てるには、この番号を使用します。 次に、この番号のアドレスを渡して packageFullNames を入力します。

[out, optional] packageFullNames

種類: PWSTR*

パッケージの完全名の文字列へのポインター。

[in, out] bufferLength

型: UINT32*

パッケージの完全名の文字列内の文字数を保持する変数へのポインター。

最初に NULL をバッファーに渡して文字数を取得します。 この番号を使用して、 バッファーにメモリ領域を割り当てます。 次に、この番号のアドレスを渡して バッファーを埋めます。

[out, optional] buffer

種類: WCHAR*

すべてのパッケージの完全名の文字の文字列。

戻り値

型: LONG

関数が成功すると、 ERROR_SUCCESSが返されます。 それ以外の場合、関数はエラー コードを返します。 考えられるエラー コードは次のとおりです。

リターン コード	説明
ERROR_INSUFFICIENT_BUFFER	1 つ以上のバッファーが、データを保持するのに十分な大きさではありません。 必要なサイズは 、count または buffer によって指定 されます。

要件

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

関連項目

PackageNameAndPublisherIdFromFamilyName