MsiDatabaseGetPrimaryKeysA, fonction (msiquery.h)
La fonction MsiDatabaseGetPrimaryKeys retourne un enregistrement contenant les noms de toutes les colonnes clés primaires 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érer la base de données. Consultez Obtention d’un handle de base de données.
[in] szTableName
Spécifie le nom de la table à partir de laquelle obtenir les noms de clé primaire.
[out] phRecord
Pointeur vers le handle de l’enregistrement qui contient les noms de clés primaires.
Valeur de retour
Cette fonction retourne UINT.
Remarques
Le nombre de champs de l’enregistrement retourné est le nombre de colonnes clés primaires retournées par la fonction MsiDatabaseGetPrimaryKeys. L’enregistrement retourné contient le nom de la table dans 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 à mesure qu’ils sortent de l’étendue, alors que vous devez fermer des objets MSIHANDLE en appelant MsiCloseHandle. Pour plus d’informations, consultez Utiliser PMSIHANDLE au lieu de la section HANDLE dans les meilleures pratiques Windows Installer.
Note
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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 |
| d’en-tête | msiquery.h |
| bibliothèque | Msi.lib |
| DLL | Msi.dll |