FindPackagesByPackageFamily 関数 (appmodel.h)

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

構文

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

パラメーター

[in] packageFamilyName

種類: PCWSTR

パッケージ ファミリ名。

[in] packageFilters

種類: UINT32

パッケージ情報の取得方法を指定するパッケージ定数。 PACKAGE_FILTER_ALL_LOADEDを除くすべてのパッケージ定数がサポートされています。

[in, out] count

型: UINT32*

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

最初に、見つかったパッケージの完全な名前の数を取得するために、packageFullNames に NULL を渡します。 packageFullNames のメモリ領域を割り当てるには、この番号を使用します。 次に、このメモリ領域のアドレスを渡して packageFullNames を埋めます。

[out, optional] packageFullNames

種類: PWSTR*

見つかったパッケージの完全名の文字列を受け取るメモリ領域へのポインター。

[in, out] bufferLength

型: UINT32*

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

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

[out, optional] buffer

種類: WCHAR*

すべてのパッケージの完全名の文字列を受け取るメモリ領域へのポインター。

[out, optional] packageProperties

型: UINT32*

検出されたすべての パッケージのパッケージ プロパティ を受け取るメモリ領域へのポインター。

戻り値

型: LONG

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

要件