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*

保存封裝完整名稱數目之變數的指標。

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

[out, optional] packageFullNames

類型： PWSTR*

封裝完整名稱字串的指標。

[in, out] bufferLength

類型： UINT32*

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

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

[out, optional] buffer

類型： WCHAR*

所有封裝完整名稱的字元字串。

傳回值

類型： LONG

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

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

規格需求

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

另請參閱

PackageNameAndPublisherIdFromFamilyName