srv_wsendmsg (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.

Sendet eine Unicode-Meldung an den Client.

Syntax

  
int srv_wsendmsg(SRV_PROC *   
srvproc  
, int   
msgnum  
, int   
severity  
, WCHAR *   
message  
, int   
msglen  
);

Argumente

srvproc
Ein Zeiger auf die SRV_PROC-Struktur, die das Handle für eine bestimmte Clientverbindung ist. Die Struktur enthält Informationen, mit der die API-Bibliothek für erweiterte gespeicherte Prozeduren die Kommunikation und Daten zwischen der Anwendung und dem Client verwaltet.

Msgnum
Eine 4-Byte-Meldungsnummer.

Severity
Gibt den Schweregrad des Fehlers an. Ein Schweregrad kleiner oder gleich 10 wird als Informationsmeldung betrachtet, bei einem höheren Wert handelt es sich um einen Fehler.

message
Ein Zeiger auf die an den Client zu sendende Unicode-Zeichenfolge.

msglen
Gibt die Länge von messagein Zeichen an.

Gibt zurück

SUCCEED oder FAIL.

Hinweise

Verwenden Sie diese Funktion, um Meldungen in Unicode zu senden. Sie ähnelt srv_sendmsg, jedoch handelt es sich bei der gesendeten Meldung um eine WCHAR-Zeichenfolge und nicht um eine Zeichenfolge des Typs DBCHAR. Beachten Sie, dass die Länge der Meldung in Zeichen und nicht in Byte angegeben wird und dass msglen niemals SRV_NULLTERM entspricht.

In folgenden Fällen gibt die Funktion FAIL zurück:

  • msglen befindet sich nicht im Bereich zwischen 0 und 32242.

  • msglen entspricht 0, der Meldungszeiger ist jedoch NULL.

  • Beim Versenden der Fehlermeldung über das Netzwerk tritt ein Fehler auf.

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.

Weitere Informationen

srv_sendmsg (API für erweiterte gespeicherte Prozeduren)