Fungsi MsiGetPatchInfoA (msi.h)

  • Artikel

Fungsi MsiGetPatchInfo mengembalikan informasi tentang patch.

Sintaks

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 Makna
INSTALLPROPERTY_LOCALPACKAGE
 Paket cache lokal.

[out] lpValueBuf

Penunjuk ke buffer yang menerima nilai properti. Parameter ini dapat berupa null.

[in, out] pcchValueBuf

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

Menampilkan nilai

Fungsi MsiGetPatchInfo mengembalikan nilai berikut.

Nilai Makna
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.
 
 

Keterangan

Ketika fungsi MsiGetPatchInfo kembali, parameter pcchValueBuf berisi panjang string kelas yang disimpan dalam buffer. Jumlah yang dikembalikan tidak termasuk karakter null yang mengakhiri.

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

   
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 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.
Target Platform Windows
Header msi.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Tidak Didukung di Windows Installer 2.0 dan yang lebih lama