srv_setcollen (Uitgebreide Opgeslagen Procedure API)

Van toepassing op:SQL Server

Important

Deze functie wordt verwijderd in een toekomstige versie van SQL Server. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die momenteel gebruikmaken van deze functie. Gebruik in plaats daarvan CLR-integratie.

Specificeert de huidige datalengte in bytes van een kolom met variabele lengte of een kolom die NULL-waarden toestaat.

Syntax

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

Arguments

srvproc
Is een verwijzing naar de SRV_PROC structuur die de handle is voor een bepaalde clientverbinding. De structuur bevat informatie die de Extended Stored Procedure API-bibliotheek gebruikt om communicatie en data tussen de applicatie en de client te beheren.

column
Geeft het nummer aan van de kolom waarvoor de gegevenslengte wordt opgegeven. Kolommen zijn genummerd beginnend met 1.

len
Geeft de lengte aan, in bytes, van de kolomgegevens. Een lengte van 0 betekent dat de kolomgegevenswaarde nul is.

Returns

SLAGEN OF MISLUKKEN.

Remarks

Elke kolom van de rij moet eerst worden gedefinieerd met srv_describe. De lengte van de kolomgegevens wordt bepaald door de laatste aanroep naar srv_describe of srv_setcollen. Als variabele lengte data (null-terminated data) verandert voor een rij, moet srv_setcollen worden gebruikt om deze op de nieuwe lengte te zetten voordat srv_sendrow wordt aangeroepen. Voor een kolom die nullwaarden toestaat, moet srv_describe zijn aangeroepen met desttype ingesteld op een datatype dat nullen toestaat (zoals SRVINTN) en nuldata wordt gespecificeerd door srv_setcollen aan te roepen met len op 0. Nul-lengte data kan niet worden gespecificeerd met de Extended Stored Procedure API.

Let op dat wanneer het datatype van de kolom variabele lengte heeft, len niet wordt aangevinkt. Deze functie geeft FAAL terug als deze wordt aangeroepen voor een kolom met vaste lengte.

Important

Je moet de broncode van extended stored procedures grondig bekijken en de gecompileerde DLL's testen voordat je ze installeert op een productieserver. Voor informatie over beveiligingsreview en testen, zie deze Microsoft-website.