srv_sendmsg (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. |
Sendet eine Meldung an den Client.
Syntax
int srv_sendmsg (
SRV_PROC *
srvproc
,
int
msgtype
,
DBINT
msgnum
,
DBTINYINT
class
,
DBTINYINT
state
,
DBCHAR *
rpcname
,
int
rpcnamelen
,
DBUSMALLINT
linenum
,
DBCHAR *
message
,
int
msglen
);
Argumente
srvproc
Ein Zeiger auf die SRV_PROC-Struktur, die das Handle für eine bestimmte Clientverbindung ist (in diesem Fall das Handle, das die Sprachanforderung erhalten hat). 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.msgtype
Ist entweder SRV_MSG_INFO oder SRV_MSG_ERROR, je nachdem, ob der Server eine Informations- oder Fehlermeldung sendet.msgnum
Eine 4-Byte-Meldungsnummer.class
Gibt den Fehlerschweregrad an. Ein Schweregrad kleiner oder gleich 10 wird als Informationsmeldung betrachtet.state
Stellt die Fehlerzustandsnummer für die aktuelle Meldung bereit. Die Fehlerzustandsnummer enthält Informationen über den Fehlerkontext. Gültige Zustandsnummern liegen zwischen 0 und 255.rpcname
Wird derzeit nicht unterstützt.rpcnamelen
Wird derzeit nicht unterstützt.linenum
Die Zeilennummer im Sprachbefehlsbatch, für die die Meldung gilt. Die Zeilennummern beginnen bei 1. Legen Sie den Wert auf 0 fest, wenn linenum nicht für die Meldung gilt.message
Ein Zeiger auf die an den Client zu sendende Zeichenfolge.msglen
Gibt die Länge von message in Byte an. Wenn message NULL-terminiert ist, legen Sie für msglen den Wert SRV_NULLTERM fest.
Rückgabewert
SUCCEED oder FAIL
Hinweise
Diese Funktion sendet Fehler- oder Informationsmeldungen an den Client. Sie wird für jede zu sendende Meldung einmal aufgerufen.
Mithilfe von srv_sendmsg können Meldungen in beliebiger Reihenfolge gesendet werden, bevor oder nachdem alle Zeilen (sofern vorhanden) mit srv_sendrow gesendet wurden. Ggf. müssen alle Meldungen an den Client gesendet werden, bevor der Abschlussstatus mit srv_senddone gesendet wird.
Zum Versenden von Meldungen in Unicode verwenden Sie srv_wsendmsg anstelle von srv_sendmsg.
Weitere Informationen finden Sie unter Unicode-Daten und Server-Codepages.
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. |