Fonction JetGetErrorInfoW

S’applique à : Windows | Windows Server

Fonction JetGetErrorInfoW

La fonction JetGetErrorInfoW BAS_ du moteur de base de données.

Remarque : Cette documentation est basée sur une version préliminaire du moteur de stockage extensible. Ces informations sont susceptibles d’être modifiées.

JET_ERR JET_API JetGetErrorInfoW( 
    _In_opt_ void *                      pvContext, 
    _Out_writes_bytes_( cbMax ) void *   pvResult, 
    _In_ unsigned long                   cbMax, 
    _In_ unsigned long                   InfoLevel, 
    _In_ JET_GRBIT                       grbit );

Paramètres

pvContext

Contexte ou valeur d’erreur pour lequel les informations d’erreur étendues sont nécessaires. La valeur passée dépend de la valeur du paramètre InfoLevel .

pvResult

Pointeur vers une mémoire tampon qui recevra les informations. Le type de la mémoire tampon dépend de la valeur du paramètre InfoLevel . L’appelant doit être configuré pour aligner la mémoire tampon de manière appropriée.

cbMax

Taille maximale de la structure pvResult passée.

InfoLevel

Le type d’informations qui seront récupérées pour les informations/le contexte d’erreur est spécifié par le paramètre pvContext . Le format des données stockées dans pvResult dépend d’InfoLevel.

Le tableau suivant répertorie les valeurs possibles pour ce paramètre.

Valeur	Signification
JET_ErrorInfoSpecificErr	pvContext est interprété comme un code JET_ERR/erreur, pvResult est interprété comme un JET_ERRINFOBASIC_W et les champs de la structure JET_ERRINFOBASIC_W sont renseignés de manière appropriée.

grbit

Réservé.

Valeur renvoyée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour répertoriés dans le tableau suivant. 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_errInvalidParameter	L’un des paramètres fournis contient une valeur inattendue ou une valeur qui n’est pas pertinente lorsqu’elle est combinée avec la valeur d’un autre paramètre. Cela peut se produire pour JetGetErrorInfo dans les cas suivants : La valeur du paramètre InfoLevel spécifiée n’est pas valide. La valeur grbit spécifiée n’est pas valide. La valeur cbMax de la mémoire tampon du paramètre pvResult spécifiée est inférieure à la taille requise pour la sortie de ce paramètre InfoLevel. Pour InfoLevel = JET_ErrorInfoSpecificErr, la valeur JET_ERR passée est inconnue du moteur.
JET_errDisabledFunctionality	Si cette référence SKU de Windows ne prend pas en charge cette fonction, cette erreur est retournée.

En cas de réussite, la mémoire tampon de sortie appropriée pour le contexte/la valeur d’erreur demandé est définie sur les informations d’erreur étendues demandées.

En cas d’échec, l’état des mémoires tampons de sortie n’est pas défini.

Notes

La fonction JET_ERRINFOBASIC_W et JET_ERRCAT groupe de constantes contiennent une documentation sur les informations d’erreur étendues retournées pour InfoLevel = JET_ErrorInfoSpecificErr.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows 8.
Serveur	Nécessite Windows 8 Server.
En-tête	Déclaré dans Esent.h.
Bibliothèque	Utilisez ESENT.lib.
DLL	Nécessite ESENT.dll.
Unicode	Remarque : Seul JetGetErrorInfoW (Unicode) est implémenté. Cette API n’a pas de version A (ANSI).