srv_senddone (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 über die Beendigung des Ergebnisses an den Client.
Syntax
int srv_senddone (
SRV_PROC *
srvproc
,
DBUSMALLINT
status
,
DBUSMALLINT
info
,
DBINT
count
);
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 denen die API-Bibliothek für erweiterte gespeicherte Prozeduren die Daten und Kommunikation zwischen der Anwendung und dem Client verwaltet.status
Ein 2-Byte-Feld für verschiedene status-Flags. Mehrere Flags können mit den logischen Operatoren AND und OR mit status-Flagwerten festgelegt werden. In der folgenden Tabelle sind die möglichen status-Flags aufgelistet.Statusflag
Beschreibung
SRV_DONE_COUNT
Der count-Parameter enthält eine gültige Anzahl.
SRV_DONE_ERROR
Der aktuelle Clientbefehl hat einen Fehler empfangen.
info
Ist ein reserviertes 2-Byte-Feld. Legen Sie diesen Wert standardmäßig auf 0 fest.count
Ein 4-Byte-Feld, das verwendet wird, um eine Anzahl für das aktuelle Resultset anzugeben. Wenn das SRV_DONE_COUNT-Flag im status-Feld festgelegt wird, enthält count eine gültige Anzahl.
Rückgabewert
SUCCEED oder FAIL
Hinweise
Eine Clientanforderung kann bewirken, dass der Server eine Reihe von Befehlen ausführt und einige Resultsets zurückgibt. Für jedes Resultset muss srv_senddone dem Client eine Meldung über die Beendigung des Ergebnisses zurückgeben.
Das count-Feld gibt die Anzahl der Zeilen an, auf die sich ein Befehl auswirkt. Wenn das count-Feld eine Anzahl enthält, sollte das SRV_DONE_COUNT-Flag im status-Feld festgelegt werden. Anhand dieser Einstellung kann der Client zwischen einem count-Feld mit dem Wert 0 und einem nicht verwendeten count-Feld unterscheiden.
Rufen Sie srv_senddone nicht von der Behandlungsroutine für SRV_CONNECT aus auf.
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. Informationen zum Überprüfen und Testen der Sicherheit finden Sie auf dieser Microsoft-Website. |