MsiViewFetch-Funktion (msiquery.h)

  • Artikel

Die MsiViewFetch-Funktion ruft den nächsten sequenziellen Datensatz aus der Ansicht ab. Diese Funktion gibt ein Handle zurück, das mit MsiCloseHandle geschlossen werden soll.

Syntax

UINT MsiViewFetch(
  [in]  MSIHANDLE hView,
  [out] MSIHANDLE *phRecord
);

Parameter

[in] hView

Handle für die Ansicht, aus der abgerufen werden soll.

[out] phRecord

Zeiger auf das Handle für den abgerufenen Datensatz.

Rückgabewert

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

Hinweise

Wenn die MsiViewFetch-Funktion ERROR_FUNCTION_FAILED zurückgibt, wurde die MsiViewExecute-Funktion möglicherweise nicht zuerst aufgerufen. Wenn mehr Zeilen im Resultset verfügbar sind, gibt MsiViewFetchphRecord als Handle an einen Datensatz zurück, der die angeforderten Spaltendaten enthält, oder phRecord ist 0. Um eine maximale Leistung zu erzielen, sollte derselbe Datensatz für alle Abrufe verwendet werden, oder der Datensatz sollte freigegeben werden, indem er den Gültigkeitsbereich übergeht.

Beachten Sie, dass die Verwendung von Variablen vom Typ PMSIHANDLE empfohlen wird, da das Installationsprogramm PMSIHANDLE-Objekte schließt, wenn sie den Gültigkeitsbereich sprengen, während Sie MSIHANDLE-Objekte durch Aufrufen von MsiCloseHandle schließen müssen. 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

Weitere Informationen

Allgemeine Datenbankzugriffsfunktionen

Arbeiten mit Abfragen