Fungsi MsiGetFeatureInfoA (msi.h)

Artikel
03/15/2023

Fungsi MsiGetFeatureInfo mengembalikan informasi deskriptif untuk fitur.

Sintaks

UINT MsiGetFeatureInfoA(
  [in]                MSIHANDLE hProduct,
  [in]                LPCSTR    szFeature,
  [out, optional]     LPDWORD   lpAttributes,
  [out, optional]     LPSTR     lpTitleBuf,
  [in, out, optional] LPDWORD   pcchTitleBuf,
  [out, optional]     LPSTR     lpHelpBuf,
  [in, out, optional] LPDWORD   pcchHelpBuf
);

Parameter

[in] hProduct

Tangani ke produk yang memiliki fitur . Handel ini diperoleh dari MsiOpenProduct.

[in] szFeature

Kode fitur untuk fitur tentang informasi mana yang harus dikembalikan.

[out, optional] lpAttributes

Arahkan ke lokasi yang berisi satu atau beberapa bendera Atribut berikut.

INSTALLFEATUREATTRIBUTE_FAVORLOCAL (1)

INSTALLFEATUREATTRIBUTE_FAVORSOURCE (2)

INSTALLFEATUREATTRIBUTE_FOLLOWPARENT (4)

INSTALLFEATUREATTRIBUTE_FAVORADVERTISE (8)

INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE (16)

INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE (32)

Untuk mengetahui informasi selengkapnya, lihat
Tabel Fitur. Nilai yang dikembalikan MsiGetFeatureInfo adalah dua kali lipat nilai di kolom Atribut tabel fitur.

[out, optional] lpTitleBuf

Arahkan ke buffer untuk menerima nama fitur yang dilokalkan, yang sesuai dengan bidang Judul di Tabel Fitur.

Parameter ini bersifat opsional dan bisa null.

[in, out, optional] pcchTitleBuf

Sebagai input, ukuran lpTitleBuf. Sebagai output, jumlah karakter yang dikembalikan dalam lpTitleBuf. Pada input, ini adalah ukuran penuh buffer, dan mencakup spasi untuk karakter null yang mengakhiri. Jika buffer yang diteruskan terlalu kecil, jumlah yang dikembalikan tidak menyertakan karakter null yang mengakhiri.

[out, optional] lpHelpBuf

Penunjuk ke buffer untuk menerima deskripsi fitur yang dilokalkan, yang sesuai dengan bidang Deskripsi untuk fitur dalam tabel Fitur. Parameter ini bersifat opsional dan bisa null.

[in, out, optional] pcchHelpBuf

Sebagai input, ukuran lpHelpBuf. Sebagai output, jumlah karakter yang dikembalikan dalam lpHelpBuf. Pada input, ini adalah ukuran penuh buffer, dan mencakup spasi untuk karakter null yang mengakhiri. Jika buffer yang diteruskan terlalu kecil, jumlah yang dikembalikan tidak menyertakan karakter null yang mengakhiri.

Menampilkan nilai

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Handel produk tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid.
ERROR_MORE_DATA	Buffer terlalu kecil untuk menyimpan data yang diminta.
ERROR_SUCCESS	Fungsi berhasil dikembalikan.
ERROR_UNKNOWN_FEATURE	Fitur ini tidak diketahui.

Keterangan

Ukuran buffer untuk fungsi MsiGetFeatureInfo harus menyertakan karakter tambahan untuk karakter null yang mengakhiri. Jika buffer terlalu kecil, string yang dikembalikan dipotong dengan null, dan ukuran buffer berisi jumlah karakter dalam seluruh string, tidak termasuk karakter null yang mengakhiri. Untuk informasi selengkapnya, lihat Memanggil Fungsi Database Dari Program.

Catatan

Header msi.h mendefinisikan MsiGetFeatureInfo 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

Fungsi Kueri Produk

Bagikan melalui