Freigeben über

  • Artikel

srv_wsendmsg (API für erweiterte gespeicherte Prozeduren)

Wichtiger HinweisWichtig

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.

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 message in Zeichen an.

Rückgabewert

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.

SicherheitshinweisSicherheitshinweis

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.