MsiCreateRecord, fonction (msiquery.h)

La fonction MsiCreateRecord crée un objet d’enregistrement avec le nombre de champs spécifié. Cette fonction retourne un handle qui doit être fermé à l’aide de MsiCloseHandle.

Syntaxe

MSIHANDLE MsiCreateRecord(
  [in] UINT cParams
);

Paramètres

[in] cParams

Spécifie le nombre de champs que l’enregistrement aura. Le nombre maximal de champs dans un enregistrement est limité à 65535.

Valeur retournée

Si la fonction réussit, la valeur de retour est gérée vers un nouvel objet d’enregistrement.

Si la fonction échoue, la valeur de retour est null.

Remarques

Le champ 0 de l’objet d’enregistrement créé par la fonction MsiCreateRecord est utilisé pour les chaînes de format et les codes d’opération et n’est pas inclus dans le nombre spécifié par cParams. Tous les champs sont initialisés à null.

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, tandis 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 de base de données

Fonctions de traitement des enregistrements