srv_message_handler (API de procédure stockée étendue)

Appelle le gestionnaire de messages de l'API de procédure stockée étendue installée. Cette fonction est habituellement utilisée pour appeler Microsoft SQL Server à partir d'une procédure stockée étendue pour journaliser une erreur (définie par la procédure stockée étendue) dans le fichier du journal des erreurs SQL Server ou le journal des applications Microsoft Windows.

Syntaxe

int srv_message_handler ( 
SRV_PROC * 
srvproc 
, 
int 
errornum 
, 
BYTE  
severity 
, 
BYTE 
state 
, 
int 
oserrnum 
, 
char * 
errtext 
, 
int 
errtextlen 
, 
char * 
oserrtext 
, 
int 
oserrtextlen 
);

Arguments

• srvproc
  Pointeur vers la structure SRV_PROC qui est le handle pour une connexion cliente particulière. Le paramètre srvproc contient des informations utilisées pour gérer les communications et les données entre l'application et le client.

• errornum
  Numéro d'erreur défini par la procédure stockée étendue. Ce numéro doit être compris entre 50 001 et 2 147 483 647.

• severity
  Valeur de gravité SQL Server standard pour l'erreur. Ce nombre doit être compris entre 0 et 24.

• state
  Valeur d'état SQL Server pour l'erreur.

• oserrnum
  Numéro d'erreur du système d'exploitation. Cet argument est ignoré.

• errtext
  Description de l'erreur de la procédure stockée étendue errornum.

• errtextlen
  Longueur de la chaîne d'erreur de la procédure stockée étendue errtext.

• oserrtext
  Description de l'erreur du système d'exploitation oserrnum. Cet argument est ignoré.

• oserrtextlen
  Longueur de la chaîne d'erreur du système d'exploitation oserrtext.

Valeurs retournées

SUCCEED ou FAIL.

Notes

La fonction srv_message_handler permet l'intégration d'une procédure stockée étendue aux fonctionnalités centralisées de journalisation des erreurs et de création de rapports de SQL Server. Vous pouvez établir des alertes SQL Server pour les événements de procédures stockées étendues, et l'Agent SQL Server surveillera ces conditions d'alerte.

Si le message d'erreur est plus long, il est tronqué à 412 octets.

Remarque relative à la sécurité
Il est recommandé de revoir en détail le code source des procédures stockées étendues et de tester les DLL compilées avant de les installer sur un serveur de production. Pour plus d'informations sur l'examen et les tests de sécurité, consultez ce site Web de Microsoft.