MsiGetFeatureInfoA-Funktion (msi.h)

Artikel
11/20/2024

Die MsiGetFeatureInfo Funktion gibt beschreibende Informationen für ein Feature zurück.

Syntax

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

Behandeln Sie das Produkt, das das Feature besitzt. Dieses Handle wird von MsiOpenProductabgerufen.

[in] szFeature

Featurecode für das Feature, zu dem Informationen zurückgegeben werden sollen.

[out, optional] lpAttributes

Zeigen Sie auf eine Position, die mindestens eins der folgenden Attributkennzeichnungen enthält.

INSTALLFEATUREATTRIBUTE_FAVORLOCAL (1)

INSTALLFEATUREATTRIBUTE_FAVORSOURCE (2)

INSTALLFEATUREATTRIBUTE_FOLLOWPARENT (4)

INSTALLFEATUREATTRIBUTE_FAVORADVERTISE (8)

INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE (16)

INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE (32)

Weitere Informationen finden Sie unter
Featuretabelle. Die Werte, die MsiGetFeatureInfo zurückgegeben werden, sind doppelte Werte in der Spalte "Attribute" der Featuretabelle.

[out, optional] lpTitleBuf

Zeigen Sie auf einen Puffer, um den lokalisierten Namen des Features zu erhalten, der dem Feld "Titel" in der Featuretabelleentspricht.

Dieser Parameter ist optional und kann null sein.

[in, out, optional] pcchTitleBuf

Als Eingabe wird die Größe lpTitleBuf. Als Ausgabe wird die Anzahl der in lpTitleBufzurückgegebenen Zeichen zurückgegeben. Bei eingaben ist dies die vollständige Größe des Puffers und enthält ein Leerzeichen für ein endendes NULL-Zeichen. Wenn der übergebene Puffer zu klein ist, enthält die zurückgegebene Anzahl nicht das endende Nullzeichen.

[out, optional] lpHelpBuf

Zeigen Sie auf einen Puffer, um die lokalisierte Beschreibung des Features zu erhalten, was dem Feld "Beschreibung" für das Feature in der Featuretabelleentspricht. Dieser Parameter ist optional und kann null sein.

[in, out, optional] pcchHelpBuf

Als Eingabe wird die Größe lpHelpBuf. Als Ausgabe wird die Anzahl der in lpHelpBufzurückgegebenen Zeichen zurückgegeben. Bei eingaben ist dies die vollständige Größe des Puffers und enthält ein Leerzeichen für ein endendes NULL-Zeichen. Wenn der übergebene Puffer zu klein ist, enthält die zurückgegebene Anzahl nicht das endende Nullzeichen.

Rückgabewert

Rückgabecode	Beschreibung
ERROR_INVALID_HANDLE	Das Produkthandle ist ungültig.
ERROR_INVALID_PARAMETER	Einer der Parameter ist ungültig.
ERROR_MORE_DATA	Ein Puffer ist zu klein, um die angeforderten Daten zu speichern.
ERROR_SUCCESS	Die Funktion wird erfolgreich zurückgegeben.
ERROR_UNKNOWN_FEATURE	Das Feature ist nicht bekannt.

Bemerkungen

Die Puffergrößen für die MsiGetFeatureInfo--Funktion sollten ein zusätzliches Zeichen für das endende Nullzeichen enthalten. Wenn ein Puffer zu klein ist, wird die zurückgegebene Zeichenfolge mit NULL abgeschnitten, und die Puffergröße enthält die Anzahl der Zeichen in der gesamten Zeichenfolge, nicht einschließlich des endenden NULL-Zeichens. Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.

Anmerkung

Der msi.h-Header definiert MsiGetFeatureInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen.
Zielplattform-	Fenster
Header-	msi.h
Library	Msi.lib
DLL-	Msi.dll

Siehe auch

Produktabfragefunktionen

Freigeben über