Fungsi GetPackagesByPackageFamily (appmodel.h)

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

Sintaks

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

Parameter

[in] packageFamilyName

Jenis: PCWSTR

Nama keluarga paket.

[in, out] count

Jenis: UINT32*

Pointer ke variabel yang menyimpan jumlah nama lengkap paket.

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

[out, optional] packageFullNames

Jenis: PWSTR*

Penunjuk ke string nama lengkap paket.

[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 nomor ini untuk mengisi buffer.

[out, optional] buffer

Jenis: WCHAR*

String karakter untuk semua nama lengkap paket.

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 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header appmodel.h
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

PackageNameAndPublisherIdFromFamilyName