MsiDatabaseGetPrimaryKeysA, fonction (msiquery.h)

  • Article

La fonction MsiDatabaseGetPrimaryKeys retourne un enregistrement contenant les noms de toutes les colonnes de clé primaire d’une table spécifiée. Cette fonction retourne un handle qui doit être fermé à l’aide de MsiCloseHandle.

Syntaxe

UINT MsiDatabaseGetPrimaryKeysA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szTableName,
  [out] MSIHANDLE *phRecord
);

Paramètres

[in] hDatabase

Gérez la base de données. Consultez Obtention d’un descripteur de base de données.

[in] szTableName

Spécifie le nom de la table à partir de laquelle obtenir les noms de clés primaires.

[out] phRecord

Pointeur vers le handle de l’enregistrement qui contient les noms de clé primaire.

Valeur retournée

Cette fonction retourne UINT.

Remarques

Le nombre de champs de l’enregistrement retourné est le nombre de colonnes de clé primaire retournées par la fonction MsiDatabaseGetPrimaryKeys . L’enregistrement retourné contient le nom de la table dans Le champ (0) et les noms de colonnes qui composent les noms de clés primaires dans les champs suivants. Ces noms de clés primaires correspondent aux numéros de colonne des champs.

Cette fonction ne peut pas être utilisée avec la table _Tables ou la table _Columns.

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.

Notes

L’en-tête msiquery.h définit MsiDatabaseGetPrimaryKeys comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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