srv_setcoldata (API für erweiterte gespeicherte Prozeduren)

Gilt für: SQL Server

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.

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

Syntax

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

Argumente

srvproc
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_setcoldataersetzt wurden oder wenn srv_senddone aufgerufen wird.

Gibt zurück

SUCCEED oder FAIL.

Hinweise

Jede Spalte der Zeile muss zuerst mit srv_describedefiniert werden. Spaltendatenadressen werden anfänglich mit srv_describefestgelegt. 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_setcollenauf 0 festgelegt wird. Die Datenadresse wird dann ignoriert.

Wichtig

Sie sollten den Quellcode der erweiterten gespeicherten Prozeduren sorgfältig prüfen, und Sie sollten die kompilierten DLL-Dateien testen, bevor Sie sie auf einem Produktionsserver installieren. Weitere Informationen zum Überprüfen und Testen der Sicherheit finden Sie auf dieser Microsoft-Website.

Weitere Informationen

srv_describe (API für erweiterte gespeicherte Prozeduren)