Partager via


MsiViewExecute, fonction (msiquery.h)

La fonction MsiViewExecute exécute une requête d’affichage SQL et fournit tous les paramètres requis. La requête utilise le jeton de point d’interrogation pour représenter les paramètres comme décrit dans Syntaxe SQL. Les valeurs de ces paramètres sont passées en tant que champs correspondants d’un enregistrement de paramètre.

Syntaxe

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

Paramètres

[in] hView

Gérez la vue sur laquelle exécuter la requête.

[in] hRecord

Gérez vers un enregistrement qui fournit les paramètres. Ce paramètre contient des valeurs pour remplacer les jetons de paramètre dans la requête SQL. Étant facultatif, hRecord peut être égal à zéro. Pour obtenir des informations de référence sur la syntaxe, consultez Syntaxe SQL.

Valeur retournée

Notez que dans les situations de mémoire insuffisante, cette fonction peut déclencher une exception STATUS_NO_MEMORY.

Remarques

La fonction MsiViewExecute doit être appelée avant tout appel à MsiViewFetch.

Si la requête SQL spécifie des valeurs avec des marqueurs de paramètres ( ?), un enregistrement doit être fourni qui contient toutes les valeurs de remplacement dans l’ordre exact et des types de données compatibles. Lorsqu’elles sont utilisées avec les requêtes INSERT et UPDATE, toutes les valeurs paramétrées doivent précéder toutes les valeurs non paramétrables.

Par exemple, ces requêtes sont valides.

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

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

Toutefois, ces requêtes ne sont pas valides.

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

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

Si la fonction échoue, vous pouvez obtenir des informations d’erreur étendues à l’aide de MsiGetLastErrorRecord.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
Plateforme cible Windows
En-tête msiquery.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions générales d’accès à la base de données