MsiDatabaseGetPrimaryKeysA, fonction (msiquery.h)
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 |