MsiViewGetColumnInfo-Funktion (msiquery.h)

Artikel
03/04/2024

Die MsiViewGetColumnInfo-Funktion gibt einen Datensatz zurück, der Spaltennamen oder Definitionen enthält. Diese Funktion gibt ein Handle zurück, das mit MsiCloseHandle geschlossen werden soll.

Syntax

UINT MsiViewGetColumnInfo(
  [in]  MSIHANDLE  hView,
  [in]  MSICOLINFO eColumnInfo,
  [out] MSIHANDLE  *phRecord
);

Parameter

[in] hView

Handle mit der Ansicht, aus der Spalteninformationen abgerufen werden sollen.

[in] eColumnInfo

Gibt ein Flag an, das angibt, welche Art von Informationen benötigt werden. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
MSICOLINFO_NAMES	Spaltennamen werden zurückgegeben.
MSICOLINFO_TYPES	Definitionen werden zurückgegeben.

[out] phRecord

Zeiger auf ein Handle, um den Spalteninformationsdatensatz zu empfangen.

Rückgabewert

Beachten Sie, dass diese Funktion in Situationen mit wenig Arbeitsspeicher eine STATUS_NO_MEMORY Ausnahme auslösen kann.

Hinweise

Die von MsiViewGetColumnInfo zurückgegebene Spaltenbeschreibung hat das format, das im Abschnitt Spaltendefinitionsformat beschrieben wird. Jede Spalte wird durch eine Zeichenfolge im entsprechenden Datensatzfeld beschrieben. Die Definitionszeichenfolge besteht aus einem einzelnen Buchstaben für den Datentyp, gefolgt von der Breite der Spalte (in Zeichen, falls zutreffend, oder in Bytes). Eine Breite von 0 (null) gibt eine unbegrenzte Breite (z. B. lange Textfelder und Datenströme) an. Ein Großbuchstabe gibt an, dass NULL-Werte in der Spalte zulässig sind.

Beachten Sie, dass es empfohlen wird, Variablen des Typs PMSIHANDLE zu verwenden, da das Installationsprogramm PMSIHANDLE-Objekte schließt, wenn sie aus dem Bereich gehen, während Sie MSIHANDLE-Objekte schließen müssen, indem Sie MsiCloseHandle aufrufen. Weitere Informationen finden Sie im Abschnitt Verwenden von PMSIHANDLE anstelle von HANDLE im Abschnitt Bewährte Methoden für Windows Installer.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (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
Zielplattform	Windows
Kopfzeile	msiquery.h
Bibliothek	Msi.lib
DLL	Msi.dll

Freigeben über