srv_setcollen (Utökat Stored Procedure API)

Gäller för:SQL Server

Important

Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen. Använd istället CLR-integration.

Specificerar den aktuella datalängden i byte för en kolumn med variabel längd eller en kolumn som tillåter NULL-värden.

Syntax

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

Arguments

srvproc
Är en pekare till den SRV_PROC struktur som är handtaget för en viss klientanslutning. Strukturen innehåller information som Extended Stored Procedure API-biblioteket använder för att hantera kommunikation och data mellan applikationen och klienten.

column
Anger antalet kolumner för vilket datalängden specificeras. Kolumnerna är numrerade med början på 1.

längd
Anger längden, i byte, på kolumndatan. En längd på 0 betyder att kolumnens datavärde är null.

Returns

SUCCEED eller FAIL.

Remarks

Varje kolumn i raden måste först definieras med srv_describe. Kolumnens datalängd bestäms av det senaste anropet till srv_describe eller srv_setcollen. Om variabellängdsdata (nullterminerad data) ändras för en rad måste srv_setcollen användas för att sätta den till den nya längden innan srv_sendrow anropas. För en kolumn som tillåter nollvärden måste srv_describe ha anropats med desttyp satt till en datatyp som tillåter null (som SRVINTN) och nulldata specificeras genom att anropa srv_setcollen med len satt till 0. Data med nolllängd kan inte specificeras med Extended Stored Procedure API.

Observera att när kolumnens datatyp är variabel längd kontrolleras inte len . Denna funktion returnerar FAIL om den anropas för en kolumn med fast längd.

Important

Du bör noggrant granska källkoden för utökade lagrade procedurer, och du bör testa de kompilerade DLL:erna innan du installerar dem på en produktionsserver. För information om säkerhetsgranskning och testning, se denna Microsoft-webbplats.