srv_message_handler (API für erweiterte gespeicherte Prozeduren)

Wichtig
Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie so bald wie möglich das Ändern von Anwendungen, in denen es zurzeit verwendet wird. Verwenden Sie stattdessen die CLR-Integration.

Ruft den installierten Meldungshandler für die API für erweiterte gespeicherte Prozeduren auf. Mit dieser Funktion wird in der Regel Microsoft SQL Server von einer erweiterten gespeicherten Prozedur aus aufgerufen, um einen (von der erweiterten gespeicherten Prozedur definierten) Fehler in der SQL Server-Fehlerprotokolldatei oder im Microsoft Windows-Anwendungsprotokoll zu erfassen.

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 ist ein Wert zwischen 50.001 und 2.147.483.647.

• severity
  Ein SQL Server-Standardwert für den Schweregrad des Fehlers. Diese Zahl ist ein Wert zwischen 0 und 24.

• state
  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.

Rückgabewert

SUCCEED oder FAIL.

Hinweise

Über die srv_message_handler-Funktion kann eine erweiterte gespeicherte Prozedur mit der zentralisierten Fehlerprotokollierung und den Berichterstellungsfunktionen von SQL Server integriert werden. Für Ereignisse in erweiterten gespeicherten Prozeduren können SQL Server-Warnungen festgelegt werden, die dann vom SQL Server-Agent überwacht werden.

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

Sicherheitshinweis
Sie sollten den Quellcode der erweiterten gespeicherten Prozeduren gründlich überprüfen. Außerdem sollten Sie die kompilierten DLLs vor der Installation auf einem Produktionsserver testen. Weitere Informationen zum Überprüfen und Testen der Sicherheit finden Sie auf dieser Microsoft-Website.