Fungsi MsiEnumPatchesW (msi.h)

Fungsi MsiEnumPatches menghitung semua patch yang telah diterapkan pada produk. Fungsi mengembalikan GUID kode patch untuk setiap patch yang telah diterapkan ke produk dan mengembalikan daftar transformasi dari setiap patch yang berlaku untuk produk. Perhatikan bahwa patch mungkin memiliki banyak transformasi hanya beberapa yang berlaku untuk produk tertentu. Daftar transformasi dikembalikan dalam format yang sama dengan nilai properti TRANSFORMS .

Sintaksis

UINT MsiEnumPatchesW(
  [in]      LPCWSTR szProduct,
  [in]      DWORD   iPatchIndex,
  [out]     LPWSTR  lpPatchBuf,
  [out]     LPWSTR  lpTransformsBuf,
  [in, out] LPDWORD pcchTransformsBuf
);

Parameter

[in] szProduct

Menentukan kode produk produk yang patchnya akan dijumlahkan.

[in] iPatchIndex

Menentukan indeks patch yang akan diambil. Parameter ini harus nol untuk panggilan pertama ke fungsi MsiEnumPatches lalu ditahapkan untuk panggilan berikutnya.

[out] lpPatchBuf

Penunjuk ke buffer yang menerima GUID patch. Argumen ini diperlukan.

[out] lpTransformsBuf

Pointer ke buffer yang menerima daftar transformasi dalam patch yang berlaku untuk produk. Argumen ini diperlukan dan tidak boleh Null.

[in, out] pcchTransformsBuf

Atur ke jumlah karakter yang disalin ke lpTransformsBuf pada pengembalian fungsi yang tidak berhasil. Tidak diatur untuk pengembalian yang berhasil. Pada input, ini adalah ukuran penuh buffer, termasuk spasi untuk karakter null yang mengakhiri. Jika buffer yang diteruskan terlalu kecil, jumlah yang dikembalikan tidak menyertakan karakter null yang mengakhiri.

Mengembalikan nilai

Komentar

Untuk menghitung patch, aplikasi awalnya harus memanggil fungsi MsiEnumPatches dengan parameter iPatchIndex diatur ke nol. Aplikasi kemudian harus meningkatkan parameter iPatchIndex dan memanggil MsiEnumPatches sampai tidak ada lagi produk (sampai fungsi kembali ERROR_NO_MORE_ITEMS).

Jika buffer terlalu kecil untuk menyimpan data yang diminta, MsiEnumPatches mengembalikan ERROR_MORE_DATA dan pcchTransformsBuf berisi jumlah karakter yang disalin ke lpTransformsBuf, tanpa menghitung karakter Null.

Persyaratan