Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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.
Definieert de kolomnaam en bron- en bestemmingsdatatypes voor een specifieke kolom in een rij.
Syntax
int srv_describe (
SRV_PROC *
srvproc
,
int
colnumber
,
DBCHAR *
column_name
,
int
namelen
,
DBINT
desttype
,
DBINT
destlen
,
DBINT
srctype
,
DBINT
srclen
,
void *
srcdata
);
Arguments
srvproc
Is een pointer naar de SRV_PROC-structuur die de handle is voor een bepaalde clientverbinding (in dit geval de client die de rij stuurt). De structuur bevat alle informatie die de Extended Stored Procedure API-bibliotheek gebruikt om communicatie en data tussen de applicatie en de client te beheren.
Colnumber
Wordt momenteel niet ondersteund. Kolommen moeten in volgorde worden beschreven. Alle kolommen moeten worden beschreven voordat srv_sendrow wordt aangeroepen.
column_name
Geeft de naam aan van de kolom waartoe de data behoort. Deze parameter kan NULL zijn omdat een kolom geen naam hoeft te hebben.
Namelen
Specificeert de lengte, in bytes, van column_name. Als namelen SRV_NULLTERM is, moet column_name ongeldig worden beëindigd.
desttype
Specificeert het datatype van de bestemmingsrijkolom. Dit is het datatype dat naar de client wordt gestuurd. Het datatype moet worden gespecificeerd, zelfs als de data NULL is; voor meer informatie, zie Data Types (Extended Stored Procedure API).
Destlen
Specificeert de lengte, in bytes, van de data die naar de client gestuurd moet worden. Voor datatypes met vaste lengte die geen nullwaarden toestaan, wordt destlen genegeerd. Voor variabele en vaste lengte datatypes die nullwaarden toestaan, specificeert destlen de maximale lengte die de bestemmingsdata mag hebben.
srctype
Specificeert het datatype van de brongegevens.
srclen
Specificeert de lengte, in bytes, van de brondata. Deze waarde wordt genegeerd voor datatypes met vaste lengte.
srcdata
Geeft het brondata-adres voor een bepaalde kolom. Wanneer srv_sendrow wordt aangeroepen, zoekt het naar de data voor colnumber bij srcdata. Daarom mag het niet worden vrijgegeven voordat er een oproep naar srv_sendrow plaatsvindt. Het bronadres kan tussen aanroepen naar srv_sendrow worden gewijzigd door gebruik te maken van srv_setcoldata. Geheugen dat voor srcdata is toegewezen, mag pas worden vrijgegeven nadat de kolomgegevens zijn vervangen door een andere aanroep naar srv_setcoldata, of totdat srv_senddone wordt aangeroepen.
Als desttype SRVDECIMAAL of SRVNUMERISCH is, moet de srcdata-parameter een verwijzing zijn naar een DBNUMERISCHE of DBDECIMALE structuur met de precisie- en schaalvelden van de structuur al ingesteld op de gewenste waarden. Je kunt DEFAULTPRECISION gebruiken om een standaardprecisie te specificeren, en DEFAULTSCALE om een standaardschaal te specificeren.
Returns
Het nummer van de beschreven kolom. De eerste kolom is kolom 1. Als er een fout optreedt, geeft 0 terug.
Remarks
De srv_describe functie moet eenmaal worden aangeroepen voor elke kolom in de rij vóór de eerste aanroep naar srv_sendrow. De kolommen van een rij kunnen in willekeurige volgorde worden beschreven.
Om de locatie en lengte van de brongegevens in kolomrijen te wijzigen voordat de volledige resultaatset is verzonden, gebruik je respectievelijk srv_setcoldata en srv_setcollen.
Voor een beschrijving van datatypes en Extended Store Procedure API-datatypeconversies, zie Data Types (Extended Stored Procedure API).
Als de kolomnaam in je applicatie in Unicode is, moet je deze converteren naar de multibyte-codepagina van de server voordat je srv_describe aanroept. Voor meer informatie, zie Unicode Data en Server Code Pages.
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.