srv_pfieldex (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 einen Zeiger auf Daten zurück, die das angeforderte SRV_PROC-Feld enthalten.

Syntax

  
void *srv_pfieldex(SRV_PROC *   
srvproc  
, int   
field  
, int *   
len  
);  

Argumente

srvproc
Ein Zeiger auf die SRV_PROC-Struktur, die das Handle für eine bestimmte Clientverbindung ist. Die Struktur enthält Informationen, mit der die API-Bibliothek für erweiterte gespeicherte Prozeduren die Kommunikation und Daten zwischen der Anwendung und dem Client verwaltet.

field
Gibt das zurückzugebende srvproc-Feld an

Feld Beschreibung Rückgabetyp
SRV_MSGLCID Aktuelle Sitzungsmeldung-LCID ULONG*
SRV_INSTANCENAME Instanzname (wenn genannt); gibt andernfalls NULL zurück WCHAR*

len
Ein Zeiger auf eine int-Variable, die die Länge des zurückgegebenen field-Werts in Byte enthält. Wenn len NULL ist, wird die Länge nicht zurückgegeben. Wenn NULL zurückgegeben wird, wird *len auf 0 (null) festgelegt.

Gibt zurück

Ein Zeiger auf Daten, deren Typ von field abhängt. NULL wird zurückgegeben, wenn len oder srvproc NULL ist. Ist field unbekannt, wird NULL zurückgegeben. Wenn NULL zurückgegeben wird, wird *len auf 0 (null) festgelegt.

Wichtig

Der vom Server zurückgegebene Puffer sollte schreibgeschützt sein. Andernfalls ist der Serverstatus möglicherweise beschädigt.

Hinweise

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 auf dieser Microsoft-Website.