srv_pfield (API für erweiterte gespeicherte Prozeduren)

Gilt für:SQL Server

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen die CLR-Integration.

Gibt Informationen zur Datenbankverbindung zurück.

Syntax

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

Argumente

srvproc
Zeiger, der eine Datenbankverbindung identifiziert

field
Gibt Daten über die Verbindung zur Rückgabe an.

Wert	Gibt zurück
SRV_APPLNAME	Der vom Client beim Herstellen der Verbindung bereitgestellte Anwendungsname.
SRV_BCPFLAG	Ein Flag, das TRUE ist, wenn sich der Client auf einen Massenkopiervorgang vorbereitet; andernfalls FALSE.
SRV_CLIB	Der Name der Bibliothek, die dem Client ermöglicht, mit einem Server zu kommunizieren.
SRV_CPID	Die Client-Prozess-ID auf dem Client-Quellcomputer.
SRV_HOST	Der vom Client beim Herstellen der Verbindung bereitgestellte Name des Clientcomputers.
SRV_LIBVERS	Die Version der Clientbibliothek.
SRV_LSECURE	Ein Flag. TRUE, wenn die Verbindung integrierte Sicherheit zur Anmeldung verwendet hat.
SRV_NETWORK_MODULE	Der Name der von der Verbindung verwendeten Netzwerkbibliotheks-DLL.
SRV_NETWORK_VERSION	Die Version der von der Verbindung verwendeten Netzwerkbibliotheks-DLL.
SRV_NETWORK_CONNECTION	Die Verbindungszeichenfolge, die an die Net-Library-DLL für die aktuelle srvproc-Verbindung übergeben wird.
SRV_PIPEHANDLE	Zeichenfolge, die das Pipehandle eines verbundenen Client enthält, oder NULL, falls der Client mit einem Netzwerk verbunden ist, das keine Named Pipes verwendet. Um dieses Handle als gültiges Pipehandle mit Microsoft Windows zu verwenden, konvertieren Sie diese Zeichenfolge in eine ganze Zahl.
SRV_RMTSERVER	Der Server, von dem der Clientprozess angemeldet wird. Wenn die Anmeldung von einem Client stammt, ist dieser Wert eine leere Zeichenfolge.
SRV_ROWSENT	Die Anzahl von Zeilen, die bereits von srvproc für die aktuellen Ergebnisse gesendet wurde.
SRV_SPID	Serverthread-ID von srvproc. Für erweiterte gespeicherte Prozeduren ist dieser Wert identisch mit der kpid-Spalte von sys.sysprocesses und kann sich im Laufe der Zeit ändern.
SRV_SPROC_CODEPAGE	Codepage, die der Server verwendet, um Multibytedaten zu interpretieren.
SRV_STATUS	Aktueller Status von srvproc: wird ausgeführt oder wurde beendet
SRV_TYPE	Verbindungstyp von srvproc. Wenn der Server zurückgegeben wird, stammt srvproc aus einer Sql Server-Instanz. Wenn ein Client zurückgegeben wird, stammt srvproc von einer DB-Bibliothek oder einem ODBC-Client.
SRV_USER	Der Benutzername der Verbindung.

len
Zeiger auf eine int-Variable, die die Länge des zurückgegebenen field-Werts enthält. Wenn len NULL ist, wird die Länge der Zeichenfolge nicht zurückgegeben.

Gibt zurück

Zeiger auf eine auf NULL endende Zeichenfolge, die den aktuellen Wert für das in der SRV_PROC-Struktur angegebene Feld enthält. Wenn das Feld leer ist, wird ein gültiger Zeiger auf eine leere Zeichenfolge zurückgegeben, und len enthält den Wert 0. Wenn das Feld unbekannt ist, wird NULL zurückgegeben, und len enthält den Wert –1.

Wichtig

Sie sollten den Quellcode der erweiterten gespeicherten Prozeduren sorgfältig prüfen, und Sie sollten die kompilierten DLL-Dateien testen, bevor Sie sie auf einem Produktionsserver installieren. Weitere Informationen zum Überprüfen und Testen der Sicherheit finden Sie im Security Developer Center.