srv_paramname (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 den Namen des Aufrufparameters für eine remote gespeicherte Prozedur zurück.

Syntax

DBCHAR * srv_paramname (
SRV_PROC * srvproc,intn, int *len );

Argumente

• srvproc
  Ist ein Zeiger auf die SRV_PROC-Struktur, die das Handle für eine bestimmte Clientverbindung ist (in diesem Fall das Handle, das den Aufruf der remote gespeicherten Prozedur erhalten hat). Die Struktur enthält Informationen, mit der die API-Bibliothek für erweiterte gespeicherte Prozeduren die Daten und Kommunikation zwischen der Anwendung und dem Client verwaltet.

• n
  Gibt die Anzahl der Parameter an. Der erste Parameter ist 1.

• len
  Stellt einen Zeiger auf eine int-Variable bereit, die die Länge des Parameternamens in Byte enthält. Wenn len NULL ist, wird die Länge des Parameternamens der remote gespeicherten Prozedur nicht zurückgegeben.

Rückgabewert

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Parameternamen enthält. Die Länge des Parameternamens wird in len gespeichert. Wenn kein nter Parameter oder keine remote gespeichere Prozedur vorhanden ist, wird NULL zurückgegeben. len wird auf -1 festgelegt, und es wird eine Informationsfehlermeldung übermittelt. Wenn der Parametername gleich NULL ist, wird len auf 0 festgelegt, und es wird eine NULL-terminierte leere Zeichenfolge zurückgegeben.

Hinweise

Diese Funktion ruft den Namen des Aufrufparameters einer remote gespeicherten Prozedur ab. Wenn eine remote gespeicherte Prozedur mit Parametern aufgerufen wird, werden die Parameter entweder über ihren Namen oder ihre Position übergeben (unbenannt). Werden beim Aufruf einer remote gespeicherten Prozedur einige Parameter über ihren Namen und einige über ihre Position übergeben, so tritt ein Fehler auf. Der SRV_RPC-Handler wird trotzdem aufgerufen, doch es sind scheinbar keine Parameter vorhanden, und srv_rpcparams gibt 0 zurück.

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.

Siehe auch

Verweis

srv_rpcparams (API für erweiterte gespeicherte Prozeduren)