JetGetTableColumnInfo fonction)
S’applique à : Windows | Windows Serveurs
JetGetTableColumnInfo fonction)
La fonction JetGetTableColumnInfo récupère des informations sur une colonne de table.
JET_ERR JET_API JetGetTableColumnInfo(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName,
__out void* pvResult,
__in unsigned long cbMax,
__in unsigned long InfoLevel
);
Paramètres
sesid
Contexte de la session de base de données à utiliser pour l’appel d’API.
TableID
Table qui contient la colonne pour laquelle extraire des informations.
szColumnName
Nom de la colonne dont les informations doivent être récupérées.
pvResult
Pointeur vers une mémoire tampon qui recevra les informations. Le type de la mémoire tampon dépend de InfoLevel. L’appelant doit être configuré pour aligner la mémoire tampon de manière appropriée.
cbMax
Taille, en octets, de la mémoire tampon qui a été passée dans pvResult.
InfoLevel
Type des informations qui seront récupérées pour la colonne spécifiée par szColumnName. Le format des données stockées dans pvResult dépend de InfoLevel. Pour obtenir le schéma de la table temporaire, consultez JET_COLUMNLIST.
JET_ColInfoListSortColumnid triera la table temporaire par ColumnID.
JET_ColInfoListCompact compacte la sortie. Pour plus d’informations sur la sortie compacte, consultez JET_COLUMNLIST.
Les options suivantes peuvent être définies pour ce paramètre :
Valeur |
Signification |
|---|---|
JET_ColInfo |
pvResult est interprété comme un JET_COLUMNDEFet les champs de la structure JET_COLUMNDEF sont remplis de manière appropriée. JET_ColInfo et JET_ColInfoByColid récupérer les mêmes informations. |
JET_ColInfoBase |
pvResult est interprété comme une structure de JET_COLUMNBASE . Cela est similaire à une structure de JET_COLUMNDEF . Si cette fonction est réussie, la structure est remplie avec les valeurs appropriées. Si cette fonction échoue, la structure contient des données non définies. |
JET_ColInfoByColid |
pvResult est interprété comme un JET_COLUMNDEF, sauf que ce InfoLevel indique que la colonne demandée (szColumName) n’est pas le nom de la colonne de chaîne, mais un pointeur vers une JET_COLUMNID. JET_ColInfo et JET_ColInfoByColid récupérer les mêmes informations. |
JET_ColInfoList |
pvResult est interprété comme une structure de JET_COLUMNLIST . Si cette fonction est réussie, la structure est remplie avec les valeurs appropriées. Une table temporaire est ouverte et identifiée par le membre TableID de JET_COLUMNLIST. La table doit être fermée avec JetCloseTable. Si cette fonction échoue, la structure contient des données non définies. |
JET_ColInfoListCompact |
pvResult est interprété comme une structure de JET_COLUMNLIST . Si cette fonction est réussie, la structure est remplie avec les valeurs appropriées. Une table temporaire est ouverte et identifiée par le membre TableID de JET_COLUMNLIST. La table doit être fermée avec JetCloseTable. Si cette fonction échoue, la structure contient des données non définies. |
JET_ColInfoListSortColumnid |
Comme JET_ColInfoList, toutefois, la table résultante est triée par ColumnID, et non par nom de colonne. |
JET_ColInfoSysTabCursor |
JET_ColInfoSysTabCursor est déconseillé et son utilisation retourne JET_errFeatureNotAvailable. |
JET_ColInfoBaseByColId |
Comme JET_ColInfoBase, pvResult est interprété comme un JET_COLUMNBASE, sauf que ce InfoLevel indique que la colonne demandée (szColumName) n’est pas le nom de la colonne de chaîne, mais un pointeur vers un JET_COLUMNID. Windows Vista : cette version est disponible dans Windows Vista et versions ultérieures. |
JET_ColInfoGrbitNonDerivedColumnsOnly |
Retourne uniquement les colonnes non dérivées (si la table est dérivée d’un modèle). Cette valeur peut être logiquement ou en InfoLevel, lorsque le InfoLevel de base est JET_ColInfoList. Windows Vista : cette valeur est introduite dans Windows Vista. |
JET_ColInfoGrbitMinimalInfo |
Retourne uniquement le nom de colonne et le ColumnID de chaque colonne. Cette valeur peut être logiquement ou en InfoLevel, lorsque le InfoLevel de base est JET_ColInfoList. Windows Vista : cette valeur est introduite dans Windows Vista. |
JET_ColInfoGrbitSortByColumnid |
Trie la liste des colonnes retournées par ColumnId (par défaut, trie la liste par nom de colonne). Cette valeur peut être logiquement ou en InfoLevel, lorsque le InfoLevel de base est JET_ColInfoList. Windows Vista : cette valeur est introduite dans Windows Vista. |
Valeur renvoyée
Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. pour plus d’informations sur les erreurs ESE possibles, consultez erreurs du moteur de Stockage Extensible et paramètres de gestion des erreurs.
Code de retour |
Description |
|---|---|
JET_errSuccess |
L’opération s’est terminée avec succès. |
JET_errColumnNotFound |
La colonne nommée szColumnName est introuvable dans la table. |
JET_errFeatureNotAvailable |
Un InfoLevel incorrect a été spécifié. |
JET_errInvalidName |
Cette erreur peut être retournée dans les cas suivants :
|
JET_errInvalidParameter |
Cette erreur peut être retournée dans les cas suivants :
|
Notes
JetGetTableColumnInfo et JetGetColumnInfo récupèrent les informations sur une colonne. La différence entre les deux est la manière dont la table est identifiée :
JetGetTableColumnInfo identifie une table par TableID.
JetGetColumnInfo identifie une table par la combinaison dbid et szTableName .
Lorsque vous récupérez des données avec JET_ColInfoList, JET_ColInfoListSortColumnid ou JET_ColInfoListCompact, une table temporaire est ouverte. La table temporaire contient des données et la structure JET_COLUMNLIST contient des informations suffisantes pour parcourir la table temporaire. La table temporaire doit être fermée avec JetCloseTable.
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista, Windows XP ou Windows 2000 Professional. |
Serveur |
nécessite Windows server 2008, Windows server 2003 ou Windows 2000 server. |
En-tête |
Déclaré dans esent. h. |
Bibliothèque |
Utilisez ESENT. lib. |
DLL |
Requiert ESENT.dll. |
Unicode |
Implémenté en tant que JetGetTableColumnInfoW (Unicode) et JetGetTableColumnInfoA (ANSI). |
Voir aussi
erreurs du moteur de Stockage Extensible
Paramètres de gestion des erreurs
JET_COLUMNBASE
JET_COLUMNDEF
JET_COLUMNID
JET_COLUMNLIST
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCloseTable
JetGetColumnInfo
JetGetTableColumnInfo