Fungsi MsiGetFeatureInfoA (msi.h)

Artikel
11/20/2024

Fungsi MsiGetFeatureInfo mengembalikan informasi deskriptif untuk fitur.

Sintaksis

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

Penunjuk 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 informasi selengkapnya, lihat
Tabel Fitur . Nilai yang pengembalian 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.

Mengembalikan nilai

Mengembalikan 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.

Komentar

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.

Nota

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

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

Fungsi Kueri Produk

Bagikan melalui