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 |
---|---|
|
一或多個緩衝區不夠大,無法保存數據。 必要的大小是由 計數 或 緩衝區所指定。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | appmodel.h |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |