MsiViewExecute-Funktion (msiquery.h)

  • Artikel

Die MsiViewExecute-Funktion führt eine SQL-Ansichtsabfrage aus und stellt alle erforderlichen Parameter bereit. Die Abfrage verwendet das Fragezeichentoken, um Parameter wie in SQL-Syntax beschrieben darzustellen. Die Werte dieser Parameter werden als entsprechende Felder eines Parameterdatensatzes übergeben.

Syntax

UINT MsiViewExecute(
  [in] MSIHANDLE hView,
  [in] MSIHANDLE hRecord
);

Parameter

[in] hView

Handle mit der Ansicht, in der die Abfrage ausgeführt werden soll.

[in] hRecord

Handle für einen Datensatz, der die Parameter bereitstellt. Dieser Parameter enthält Werte, um die Parametertoken in der SQL-Abfrage zu ersetzen. Es ist optional, sodass hRecord 0 sein kann. Eine Referenz zur Syntax finden Sie unter SQL-Syntax.

Rückgabewert

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

Hinweise

Die MsiViewExecute-Funktion muss vor allen Aufrufen von MsiViewFetch aufgerufen werden.

Wenn die SQL-Abfrage Werte mit Parametermarkern (?) angibt, muss ein Datensatz angegeben werden, der alle Ersatzwerte in der genauen Reihenfolge und kompatibler Datentypen enthält. Bei Verwendung mit INSERT- und UPDATE-Abfragen müssen alle parametrisierten Werte allen nicht parametrisierten Werten vorangestellt werden.

Diese Abfragen sind beispielsweise gültig.

UPDATE {table-list} SET {column}= ? , {column}= {constant}

INSERT INTO {table} ({column-list}) VALUES (?, {constant-list})

Diese Abfragen sind jedoch ungültig.

UPDATE {table-list} SET {column}= {constant}, {column}=?

INSERT INTO {table} ({column-list}) VALUES ({constant-list}, ? )

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.

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