srv_pfield (API voor uitgebreide opgeslagen procedures)

van toepassing op:SQL Server-

Belangrijk

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.

Retourneert informatie over een databaseverbinding.

Syntaxis

  
DBCHAR * srv_pfield (  
SRV_PROC *  
srvproc  
,  
int   
field  
,  
int *  
len  
);  

Argumenten

srvproc-
Aanwijzer voor het identificeren van een databaseverbinding.

veld
Hiermee geeft u gegevens op voor de verbinding die moet worden geretourneerd.

Waarde	Retourneert
SRV_APPLNAME	De toepassingsnaam die door de client is opgegeven toen de verbinding tot stand werd gebracht.
SRV_BCPFLAG	Een vlag die WAAR is als de client zich voorbereidt op een bulkkopiebewerking; anders, ONWAAR.
SRV_CLIB	De naam van de bibliotheek waarmee de client met een server kan communiceren.
SRV_CPID	De clientproces-id op de clientbroncomputer.
SRV_HOST	De naam van de computer van de client die door de client wordt geleverd toen de verbinding tot stand werd gebracht.
SRV_LIBVERS	De versie van de clientbibliotheek.
SRV_LSECURE	Een vlag. WAAR als de verbinding geïntegreerde beveiliging heeft gebruikt om u aan te melden.
SRV_NETWORK_MODULE	De naam van de Net-Library DLL die door de verbinding wordt gebruikt.
SRV_NETWORK_VERSION	De versie van de Net-Library DLL die door de verbinding wordt gebruikt.
SRV_NETWORK_CONNECTION	De verbindingsreeks die is doorgegeven aan de Net-Library DLL die wordt gebruikt voor de huidige srvproc--verbinding.
SRV_PIPEHANDLE	Een tekenreeks met de pijpgreep van een verbonden client of NULL als de client is verbonden in een netwerk dat geen benoemde pijpen gebruikt. Als u deze ingang wilt gebruiken als een geldige sluisgreep met Microsoft Windows, converteert u deze tekenreeks naar een geheel getal.
SRV_RMTSERVER	De server van waaruit het clientproces is aangemeld. Als de aanmelding afkomstig is van een client, is deze waarde een lege tekenreeks.
SRV_ROWSENT	Het aantal rijen dat al is verzonden door srvproc voor de huidige set resultaten.
SRV_SPID	De serverthread-id van de srvproc-. Voor uitgebreide opgeslagen procedures is deze waarde hetzelfde als de kpid kolom van sys.sysprocessesen kan deze in de loop van de tijd veranderen.
SRV_SPROC_CODEPAGE	Codepagina die door de server wordt gebruikt om multibyte-gegevens te interpreteren.
SRV_STATUS	De huidige status van srvproc-: actief of gesloten
SRV_TYPE	Het verbindingstype van srvproc-. Als de server wordt geretourneerd, srvproc- afkomstig is van een exemplaar van SQL Server. Als de client wordt geretourneerd, is srvproc- afkomstig van een DB-Library- of ODBC-client.
SRV_USER	De gebruikersnaam van de verbinding.

len
Is een aanwijzer naar een int variabele die de lengte bevat van het geretourneerde veld waarde. Als lengte NULL is, wordt de lengte van de tekenreeks niet geretourneerd.

Retourneert

Een aanwijzer naar een door null beëindigde tekenreeks met de huidige waarde voor het opgegeven veld in de SRV_PROC structuur. Als het veld leeg is, wordt een geldige aanwijzer naar een lege tekenreeks geretourneerd en len 0 bevat. Als het veld onbekend is, wordt NULL geretourneerd en len de waarde -1 bevat.

Belangrijk

Controleer de broncode van uitgebreide opgeslagen procedures grondig en test de gecompileerde DLL's voordat u ze op een productieserver installeert. Zie de Security Developer Centervoor informatie over beveiligingsbeoordeling en -tests.