Fungsi MsiGetPatchFileListA (msi.h)

Artikel
11/20/2024

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

Sintaksis

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 dapat null.

[in] szPatchPackages

Nilai string null-terminated yang berisi daftar patch Penginstal 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 ini 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 file yang dapat diperbarui ketika daftar patch di szPatchList diterapkan pada komputer ini. Parameter ini diperlukan.

Mengembalikan nilai

Fungsi MsiGetPatchFileList mengembalikan nilai berikut.

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

Komentar

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.

Nota

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

Syarat	Nilai
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 pada Windows Server 2008 atau Windows Vista. Windows Installer 4.5 pada Windows Server 2003 dan Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Platform Target	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Tidak Didukung di Windows Installer 3.1 dan versi yang lebih lama

Bagikan melalui