MsiViewExecute-Funktion (msiquery.h)

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

Weitere Informationen

Allgemeine Datenbankzugriffsfunktionen