Fungsi MsiGetPatchFileListA (msi.h)

Artikel
08/24/2023

Fungsi MsiGetPatchFileList disediakan daftar file .msp, dibatasi oleh titik koma, dan mengambil daftar file yang dapat diperbarui oleh patch.

Sintaks

UINT MsiGetPatchFileListA(
  [in]      LPCSTR    szProductCode,
  [in]      LPCSTR    szPatchPackages,
  [in, out] LPDWORD   pcFiles,
  [in, out] MSIHANDLE **pphFileRecords
);

Parameter

[in] szProductCode

Nilai string null-terminated yang berisi ProductCode (GUID) produk yang merupakan target patch. Parameter ini tidak boleh NULL.

[in] szPatchPackages

Nilai string yang dihentikan null yang berisi daftar patch Pemasang Windows (file.msp). Setiap patch dapat ditentukan oleh jalur lengkap ke paket patch. Patch dalam daftar dibatasi oleh titik koma. Setidaknya satu patch harus ditentukan.

[in, out] pcFiles

Penunjuk ke lokasi yang menerima jumlah file yang akan diperbarui pada sistem ini dengan daftar patch yang ditentukan oleh szPatchList. Parameter ini diperlukan.

[in, out] pphFileRecords

Penunjuk ke lokasi yang menerima penunjuk ke array rekaman. Bidang pertama (0-indeks) dari setiap rekaman berisi jalur file lengkap dari file yang dapat diperbarui ketika daftar patch di szPatchList diterapkan pada komputer ini. Parameter ini diperlukan.

Nilai kembali

Fungsi MsiGetPatchFileList mengembalikan nilai berikut.

Nilai	Makna
ERROR_SUCCESS	Fungsi berhasil diselesaikan.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_FUNCTION_FAILED	Fungsi gagal.

Keterangan

Misalnya, szPatchList dapat memiliki nilai: "c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp".

Fungsi ini berjalan dalam konteks pemanggil. Kode produk dicari dalam urutan konteks yang tidak dikelola pengguna, konteks yang dikelola pengguna, dan konteks komputer.

Anda harus menutup semua objek MSIHANDLE yang dikembalikan oleh fungsi ini dengan memanggil fungsi MsiCloseHandle .

Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan fungsi MsiGetLastErrorRecord .

Untuk informasi selengkapnya tentang menggunakan fungsi MsiGetPatchFileList lihat Mencantumkan File yang dapat Diperbarui.

Catatan

Header msi.h mendefinisikan MsiGetPatchFileList sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Windows Installer 4.5 di Windows Server 2003 dan Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Pemasang Windows.
Target Platform	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Tidak Didukung di Windows Installer 3.1 dan versi yang lebih lama