共用方式為

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*

變數的指標，其中包含找到的封裝完整名稱數目。

首先，您會將 NULL 傳遞至 packageFullNames ，以取得找到的套件完整名稱數目。 您可以使用這個數位來配置 packageFullNames 的記憶體空間。 然後，您傳遞此記憶體空間的位址以填滿 packageFullNames。

[out, optional] packageFullNames

類型： PWSTR*

記憶體空間的指標，接收找到之封裝完整名稱的字串。

[in, out] bufferLength

類型： UINT32*

變數的指標，該變數會保存封裝完整名稱字串中的字元數。

首先，您會將 NULL 傳遞至 緩衝區 ，以取得字元數。 您可以使用這個數位來配置 緩衝區的記憶體空間。 然後，您將這個記憶體空間的位址傳遞至填滿 緩衝區。

[out, optional] buffer

類型： WCHAR*

記憶體空間的指標，接收所有封裝完整名稱的字元字串。

[out, optional] packageProperties

類型： UINT32*

記憶體空間的指標，可接收找到之所有 封裝的封裝屬性 。

傳回值

類型： LONG

如果函式成功，它會傳回 ERROR_SUCCESS。 否則，函式會傳回錯誤碼。 可能的錯誤碼包括下列各項。

傳回碼 Description
ERROR_INSUFFICIENT_BUFFER
 一或多個緩衝區不夠大，無法保存數據。 所需的大小是由 計數 或 緩衝區所指定。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 appmodel.h
程式庫 Kernel32.lib
DLL Kernel32.dll