MsiViewFetch, fonction (msiquery.h)

  • Article

La fonction MsiViewFetch extrait l’enregistrement séquentiel suivant à partir de la vue. Cette fonction retourne un handle qui doit être fermé à l’aide de MsiCloseHandle.

Syntaxe

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

Paramètres

[in] hView

Gérez la vue à partir de laquelle extraire.

[out] phRecord

Pointeur vers le handle de l’enregistrement extrait.

Valeur retournée

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

Remarques

Si la fonction MsiViewFetch retourne ERROR_FUNCTION_FAILED, il est possible que la fonction MsiViewExecute n’ait pas été appelée en premier. Si d’autres lignes sont disponibles dans le jeu de résultats, MsiViewFetch retourne phRecord en tant que handle à un enregistrement contenant les données de colonne demandées, ou phRecord est égal à 0. Pour des performances maximales, le même enregistrement doit être utilisé pour toutes les récupérations, ou l’enregistrement doit être libéré en sortant de l’étendue.

Notez qu’il est recommandé d’utiliser des variables de type PMSIHANDLE, car le programme d’installation ferme les objets PMSIHANDLE en dehors de leur portée, alors que vous devez fermer les objets MSIHANDLE en appelant MsiCloseHandle. Pour plus d’informations, consultez la section Utiliser PMSIHANDLE au lieu de HANDLE dans les Bonnes pratiques de Windows Installer.

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

Utilisation des requêtes