Fungsi MsiGetPatchInfoA (msi.h)

Artikel
20/11/2024

Fungsi MsiGetPatchInfo mengembalikan informasi tentang patch.

Sintaksis

UINT MsiGetPatchInfoA(
  [in]      LPCSTR  szPatch,
  [in]      LPCSTR  szAttribute,
  [out]     LPSTR   lpValueBuf,
  [in, out] LPDWORD pcchValueBuf
);

Parameter

[in] szPatch

Menentukan kode patch untuk paket patch.

[in] szAttribute

Menentukan atribut yang akan diambil.

Atribut	Arti
INSTALLPROPERTY_LOCALPACKAGE	Paket cache lokal.

[out] lpValueBuf

Penunjuk ke buffer yang menerima nilai properti. Parameter ini bisa null.

[in, out] pcchValueBuf

Penunjuk ke variabel yang menentukan ukuran, dalam karakter, dari buffer yang ditujukkan oleh parameter lpValueBuf . 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.

Jika lpValueBuf null, pcchValueBuf bisa null.

Mengembalikan nilai

Fungsi MsiGetPatchInfo mengembalikan nilai berikut.

Nilai	Arti
ERROR_BAD_CONFIGURATION	Data konfigurasi rusak.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_MORE_DATA	Buffer terlalu kecil untuk menyimpan data yang diminta.
ERROR_SUCCESS	Fungsi berhasil diselesaikan.
ERROR_UNKNOWN_PRODUCT	Paket patch tidak diinstal.
ERROR_UNKNOWN_PROPERTY	Properti tidak dikenali.

Komentar

Saat fungsi MsiGetPatchInfo kembali, parameter pcchValueBuf berisi panjang string kelas yang disimpan dalam buffer. Jumlah yang dikembalikan tidak menyertakan karakter null yang dihentikan.

Jika buffer terlalu kecil untuk menyimpan data yang diminta, MsiGetPatchInfo mengembalikan ERROR_MORE_DATA, dan pcchValueBuf berisi jumlah karakter yang disalin ke lpValueBuf, tanpa menghitung karakter null.

Catatan

Header msi.h mendefinisikan MsiGetPatchInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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 pada Windows Server 2003 atau 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 2.0 dan yang lebih lama

Bagikan melalui