srv_pfield (API für erweiterte gespeicherte Prozeduren)

Wichtig
Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie so bald wie möglich das Ändern von Anwendungen, in denen es zurzeit verwendet wird. 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	Rückgabewert
  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 Netzwerkbibliotheks-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, wandeln Sie die Zeichenfolge in eine Ganzzahl um.
  SRV_RMTSERVER	Der Server, von dem sich der Clientprozess anmeldet. Falls die Anmeldung von einem Client erfolgt, ist der Wert eine leere Zeichenfolge.
  SRV_ROWSENT	Die Anzahl von Zeilen, die bereits von srvproc für das aktuelle Resultset 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 Server zurückgegeben wird, ist srvproc von einer Instanz von SQL Server. Wenn Client zurückgegeben wird, ist srvproc von einer DB-Bibliothek oder einem ODBC-Client.
  SRV_USER	Name des Benutzers dieser 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.

Rückgabewert

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 0. Wenn das Feld unbekannt ist, wird NULL zurückgegeben, und len enthält den Wert -1.

Sicherheitshinweis
Sie sollten den Quellcode der erweiterten gespeicherten Prozeduren gründlich überprüfen. Außerdem sollten Sie die kompilierten DLLs vor der Installation auf einem Produktionsserver testen. Weitere Informationen zum Überprüfen und Testen der Sicherheit finden Sie im Security Developer Center.