Freigeben über

  • Artikel

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

Gibt die aktuelle Adresse für die Daten einer Spalte an.

Syntax


int srv_setcoldata (
SRV_PROC *
srvproc
,
int 
column
,
void *
data 
);

Argumente

  • srvproc
    Ist 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.

  • column
    Gibt die Nummer der Spalte an, für die die Adresse angegeben wird. Die Spalten sind fortlaufend nummeriert, beginnend mit 1.

  • data
    Ist ein Zeiger für die Daten einer Spalte. Der data zugewiesene Speicher sollte erst freigegeben werden, wenn die Spaltendaten durch einen anderen Aufruf von srv_setcoldata ersetzt wurden oder wenn srv_senddone aufgerufen wird.

Rückgabewerte

SUCCEED oder FAIL.

Hinweise

Jede Spalte der Zeile muss zuerst mit srv_describe definiert werden. Spaltendatenadressen werden anfänglich mit srv_describe festgelegt. Wenn sich die Adresse der Spaltendaten ändert, muss srv_setcoldata aufgerufen werden, um die neue Adresse der Daten anzugeben. Für jede geänderte Spalte muss srv_setcoldata separat aufgerufen werden.

NULL-Daten werden dargestellt, indem die Länge der Spalte mit srv_setcollen auf 0 festgelegt wird. Die Datenadresse wird dann ignoriert.

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.