Fungsi FindPackagesByPackageFamily (appmodel.h)

Menemukan paket dengan nama keluarga yang ditentukan untuk pengguna saat ini.

Sintaks

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
);

Parameter

[in] packageFamilyName

Jenis: PCWSTR

Nama keluarga paket.

[in] packageFilters

Jenis: UINT32

Konstanta paket yang menentukan bagaimana informasi paket diambil. Semua konstanta paket kecuali PACKAGE_FILTER_ALL_LOADED didukung.

[in, out] count

Jenis: UINT32*

Penunjuk ke variabel yang menyimpan jumlah nama lengkap paket yang ditemukan.

Pertama Anda meneruskan NULL ke packageFullNames untuk mendapatkan jumlah nama lengkap paket yang ditemukan. Anda menggunakan nomor ini untuk mengalokasikan ruang memori untuk packageFullNames. Kemudian Anda meneruskan alamat ruang memori ini untuk mengisi packageFullNames.

[out, optional] packageFullNames

Jenis: PWSTR*

Penunjuk ke ruang memori yang menerima string nama lengkap paket yang ditemukan.

[in, out] bufferLength

Jenis: UINT32*

Penunjuk ke variabel yang menyimpan jumlah karakter dalam string nama lengkap paket.

Pertama Anda meneruskan NULL ke buffer untuk mendapatkan jumlah karakter. Anda menggunakan nomor ini untuk mengalokasikan ruang memori untuk buffer. Kemudian Anda meneruskan alamat ruang memori ini untuk mengisi buffer.

[out, optional] buffer

Jenis: WCHAR*

Pointer ke ruang memori yang menerima string karakter untuk semua nama lengkap paket.

[out, optional] packageProperties

Jenis: UINT32*

Pointer ke ruang memori yang menerima properti paket untuk semua paket yang ditemukan.

Nilai kembali

Jenis: LONG

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan. Kode kesalahan yang mungkin mencakup yang berikut ini.

Menampilkan kode	Deskripsi
ERROR_INSUFFICIENT_BUFFER	Satu atau beberapa buffer tidak cukup besar untuk menyimpan data. Ukuran yang diperlukan ditentukan oleh hitungan atau buffer.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	appmodel.h
Pustaka	Kernel32.lib
DLL	Kernel32.dll