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 zum Interpretieren von Multibyte-Daten verwendet. |
| 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.