ISQLServerErrorInfo::GetErrorInfo (OLE DB)
Retourne un pointeur vers la structure SSERRORINFO du fournisseur OLE DB SQL Server Native Client qui contient les détails de l'erreur SQL Server.
Syntaxe
HRESULT GetErrorInfo(
SSERRORINFO**ppSSErrorInfo,
OLECHAR**ppErrorStrings);
Arguments
ppSSErrorInfo[out]
Pointeur vers une structure SSERRORINFO. Si la méthode échoue ou qu'il n'existe pas d'informations SQL Server associées à l'erreur, le fournisseur n'alloue pas de mémoire et vérifie que l'argument ppSSErrorInfo est un pointeur null en sortie.ppErrorStrings[out]
Pointeur vers un pointeur de chaîne de caractère Unicode. Si la méthode échoue ou qu'il n'existe pas d'informations SQL Server associées à une erreur, le fournisseur n'alloue pas de mémoire et vérifie que l'argument ppErrorStrings est un pointeur null en sortie. La libération de l'argument ppErrorStrings avec la méthode IMalloc::Free libère les trois membres de type chaîne individuels de la structure SSERRORINFO retournée, la mémoire étant allouée dans un bloc.
Valeurs de code de retour
S_OK
La méthode a réussi.E_INVALIDARG
L'argument ppSSErrorInfo ou ppErrorStrings était NULL.E_OUTOFMEMORY
Le fournisseur OLE DB SQL Server Native Client n'a pas pu allouer une mémoire suffisante pour compléter la demande.
Notes
Le fournisseur OLE DB SQL Server Native Client alloue la mémoire pour les chaînes SSERRORINFO et OLECHAR retournées à travers les pointeurs passés par le consommateur. Le consommateur doit libérer cette mémoire en utilisant la méthode IMalloc::Free quand il n'est plus nécessaire d'accéder aux données d'erreur.
La structure SSERRORINFO est définie comme suit :
typedef struct tagSSErrorInfo
{
LPOLESTR pwszMessage;
LPOLESTR pwszServer;
LPOLESTR pwszProcedure;
LONG lNative;
BYTE bState;
BYTE bClass;
WORD wLineNumber;
}
SSERRORINFO;
Membre |
Description |
|---|---|
pwszMessage |
Message d'erreur de SQL Server. Le message est retourné via la méthode IErrorInfo::GetDescription . |
pwszServer |
Nom de l'instance SQL Server sur laquelle l'erreur s'est produite. |
pwszProcedure |
Le nom de la procédure stockée qui génère l'erreur si l'erreur s'est produite dans une procédure stockée ; sinon, une chaîne vide. |
lNative |
Numéro d'erreur SQL Server. Le numéro d'erreur est identique à celui retourné dans le paramètre plNativeError de la méthode ISQLErrorInfo::GetSQLInfo. |
bState |
État de l'erreur SQL Server. |
bClass |
Gravité de l'erreur SQL Server. |
wLineNumber |
Le cas échéant, la ligne d'une procédure stockée SQL Server qui a généré le message d'erreur. Si aucune pocédure n'est impliquée, la valeur par défaut est 1. |
Pointeurs dans les adresses de type référence de la structure de la chaîne retournée dans l'argument ppErrorStrings.