Freigeben über

  • Artikel

srv_setcollen (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 Datenlänge in Byte einer Spalte mit variabler Länge oder einer Spalte an, die NULL-Werte zulässt.

Syntax


int srv_setcollen (
SRV_PROC *
srvproc
,
int 
column
,
int
len 
);

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 Daten und Kommunikation zwischen der Anwendung und dem Client verwaltet.

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

  • len
    Gibt die Länge der Spaltendaten in Byte an. Eine Länge von 0 bedeutet, dass der Spaltendatenwert NULL ist.

Rückgabewert

SUCCEED oder FAIL.

Hinweise

Jede Spalte der Zeile muss zuerst mit srv_describe definiert werden. Die Spaltendatenlänge wird vom letzten Aufruf von srv_describe oder srv_setcollen festgelegt. Wenn Daten mit variabler Länge (null-terminierte Daten) für eine Zeile geändert werden, muss diese mit srv_setcollen auf die neue Länge festgelegt werden, bevor srv_sendrow aufgerufen wird. Für eine Spalte, die NULL-Werte zulässt, muss srv_describe mit einem auf einen Datentyp festgelegten desttype-Wert aufgerufen worden sein, der NULL-Werte zulässt (wie SRVINTN), und NULL-Daten werden durch Aufrufen von srv_setcollen angegeben, wobei len auf 0 festgelegt ist. Daten der Länge 0 (NULL) können nicht mit der API für erweiterte gespeicherte Prozeduren angegeben werden.

Wenn der Datentyp der Spalte von variabler Länge ist, ist len nicht aktiviert. Diese Funktion gibt FAIL zurück, wenn sie für eine Spalte mit fester Länge aufgerufen wird.

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.