Freigeben über

  • Artikel

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

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. Informationen zum Überprüfen und Testen der Sicherheit finden Sie auf dieser Microsoft-Website.