srv_message_handler (API für erweiterte gespeicherte Prozeduren)

  • Artikel

Gilt für: SQL Server

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen die CLR-Integration.

Ruft den installierten Meldungshandler für die API für erweiterte gespeicherte Prozeduren auf. Diese Funktion wird in der Regel verwendet, um Microsoft SQL Server aus einer erweiterten gespeicherten Prozedur aufzurufen, um einen Fehler (definiert durch die erweiterte gespeicherte Prozedur) in der SQL Server-Fehlerprotokolldatei oder im Microsoft Windows-Anwendungsprotokoll zu protokollieren.

Syntax

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

Argumente

srvproc
Ein Zeiger auf die SRV_PROC-Struktur, die das Handle für eine bestimmte Clientverbindung ist. Der srvproc-Parameter enthält Informationen, mit denen die Daten und die Kommunikation zwischen der Anwendung und dem Client verwaltet werden.

errornum
Eine von der erweiterten gespeicherten Prozedur definierte Fehlernummer. Diese Zahl muss zwischen 50.001 und 2.147.483.647 liegen.

severity
Ist ein standardmäßiger SQL Server-Schweregrad für den Fehler. Diese Zahl ist ein Wert zwischen 0 und 24.

state
Ist ein SQL Server-Statuswert für den Fehler.

oserrnum
Die Nummer des Betriebssystemfehlers. Dieses Argument wird ignoriert.

errtext
Die Beschreibung des Fehlers der erweiterten gespeicherten Prozedur errornum.

errtextlen
Die Länge der Fehlerzeichenfolge der erweiterten gespeicherten Prozedur errtext.

oserrtext
Die Beschreibung des Betriebssystemfehlers oserrnum. Dieses Argument wird ignoriert.

oserrtextlen
Die Länge der Zeichenfolge des Betriebssystemfehlers oserrtext.

Gibt zurück

SUCCEED oder FAIL.

Hinweise

Die funktion srv_message_handler ermöglicht eine erweiterte gespeicherte Prozedur, die in die zentralisierte Fehlerprotokollierung und Berichterstellungsfunktionen von SQL Server integriert werden kann. SQL Server-Warnungen können für Ereignisse aus erweiterten gespeicherten Prozeduren eingerichtet werden, und SQL Server-Agent überwacht diese Warnungsbedingungen.

Wenn die Fehlermeldung zu lang ist, wird sie bei 412 Byte abgeschnitten.

Wichtig

Sie sollten den Quellcode der erweiterten gespeicherten Prozeduren sorgfältig prüfen, und Sie sollten die kompilierten DLL-Dateien testen, bevor Sie sie auf einem Produktionsserver installieren. Weitere Informationen zum Überprüfen und Testen der Sicherheit finden Sie auf dieser Microsoft-Website.