Funzione MsiViewExecute (msiquery.h)

La funzione MsiViewExecute esegue una query di visualizzazione SQL e fornisce tutti i parametri necessari. La query usa il token del punto interrogativo per rappresentare i parametri come descritto in Sintassi SQL. I valori di questi parametri vengono passati come campi corrispondenti di un record di parametro.

Sintassi

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

Parametri

[in] hView

Gestire la vista su cui eseguire la query.

[in] hRecord

Handle per un record che fornisce i parametri. Questo parametro contiene valori per sostituire i token dei parametri nella query SQL. È facoltativo, quindi hRecord può essere zero. Per informazioni di riferimento sulla sintassi, vedere Sintassi SQL.

Valore restituito

Si noti che in situazioni di memoria insufficiente questa funzione può generare un'eccezione STATUS_NO_MEMORY.

Commenti

La funzione MsiViewExecute deve essere chiamata prima di qualsiasi chiamata a MsiViewFetch.

Se la query SQL specifica valori con marcatori di parametro (?), è necessario specificare un record contenente tutti i valori di sostituzione nell'ordine esatto e nei tipi di dati compatibili. Se usato con le query INSERT e UPDATE, tutti i valori con parametri devono precedere tutti i valori non parametrizzati.

Ad esempio, queste query sono valide.

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

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

Tuttavia, queste query non sono valide.

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

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

Se la funzione ha esito negativo, è possibile ottenere informazioni estese sull'errore usando MsiGetLastErrorRecord.

Requisiti

Vedi anche

Funzioni generali di accesso al database