srv_senddone (API für erweiterte gespeicherte Prozeduren)

Artikel
03/12/2024

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 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 der die API-Bibliothek für erweiterte gespeicherte Prozeduren die Kommunikation und Daten 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.

Gibt zurück

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.