srv_paramname (Extended Stored Procedure API)

Wichtig:
Dieses Feature wird in einer zukünftigen Version von Microsoft SQL Server entfernt. Verwenden Sie dieses Feature nicht zum Entwickeln neuer Anwendungen, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird, zum frühstmöglichen Zeitpunkt ein. Use CLR integration instead.

Returns the name of a remote stored procedure call parameter.

Syntax

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

Arguments

• srvproc
  Is a pointer to the SRV_PROC structure that is the handle for a particular client connection (in this case, the handle that received the remote stored procedure call). The structure contains information the Extended Stored Procedure API library uses to manage communication and data between the application and the client.

• n
  Indicates the number of the parameter. The first parameter is 1.

• len
  Provides a pointer to an int variable that contains the length, in bytes, of the parameter name. If len is NULL, the length of the remote stored procedure parameter name is not returned.

Returns

A pointer to a null-terminated character string that contains the parameter name. The length of the parameter name is stored in len. If there is no nth parameter or no remote stored procedure, it returns NULL, len is set to -1, and an informational error message is sent. If the parameter name is NULL, len is set to 0 and a null-terminated empty string is returned.

Hinweise

This function gets the name of a remote stored procedure call parameter. When a remote stored procedure call is made with parameters, the parameters can be passed either by name or by position (unnamed). If the remote stored procedure call is made with some parameters passed by name and some passed by position, an error occurs. The SRV_RPC handler is still called, but it appears as if there were no parameters, and srv_rpcparams returns 0.

Sicherheitshinweis:
You should thoroughly review the source code of extended stored procedures, and you should test the compiled DLLs before you install them on a production server. For information about security review and testing, see this Microsoft Web site.

Siehe auch

Verweis

srv_rpcparams (Extended Stored Procedure API)

Hilfe und Informationen

Informationsquellen für SQL Server 2005