Fungsi MsiOpenPackageA (msi.h)

  • Artikel

Fungsi MsiOpenPackage membuka paket untuk digunakan dengan fungsi yang mengakses database produk. Fungsi MsiCloseHandle harus dipanggil dengan handel ketika handel tidak diperlukan.

Catatan Inisialisasi COM pada utas yang sama sebelum memanggil fungsi MsiOpenPackage, MsiOpenPackageEx, atau MsiOpenProduct .

 

Sintaks

UINT MsiOpenPackageA(
  [in]  LPCSTR    szPackagePath,
  [out] MSIHANDLE *hProduct
);

Parameter

[in] szPackagePath

Jalur ke paket.

[out] hProduct

Penunjuk ke variabel yang menerima handel produk.

Nilai kembali

Nilai Makna
ERROR_BAD_CONFIGURATION
 Informasi konfigurasi rusak.
ERROR_INSTALL_FAILURE
 Produk tidak dapat dibuka.
ERROR_INSTALL_REMOTE_PROHIBITED
 Pemasang Windows tidak mengizinkan penginstalan dari sambungan desktop jarak jauh.
ERROR_INVALID_PARAMETER
 Parameter yang tidak valid diteruskan ke fungsi.
ERROR_SUCCESS
 Fungsi berhasil diselesaikan.
 

Jika fungsi ini gagal, fungsi ini dapat mengembalikan kode kesalahan sistem. Untuk informasi selengkapnya, lihat Kode Kesalahan Sistem.

Keterangan

MsiOpenPackage dapat menerima handel database yang dibuka dalam bentuk "#nnnn", di mana nnnn adalah handel database dalam bentuk string, yaitu #123, bukan jalur ke paket. Ini ditujukan untuk tugas pengembangan seperti menjalankan tindakan validasi, atau untuk digunakan dengan alat manajemen database.

Catatan

Header msi.h mendefinisikan MsiOpenPackage sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan 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 di Windows Server 2008 atau Windows Vista. Pemasang Windows pada Windows Server 2003 atau 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

Fungsi Kueri Produk