srv_rpcname

Returns the procedure name component for the current remote stored procedure.

Syntax

DBCHAR * srv_rpcname (
SRV_PROC * srvproc,
int * len );

where

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). The structure contains the information that the ODS Library uses to manage communication and data between the Open Data Services server application and the client.

len

Is a pointer to an integer variable that receives the length of the database name. If len is NULL, the length of the remote stored procedure name isn't returned.

Returns

A DBCHAR pointer to the null-terminated string for the remote stored procedure name component of the current remote stored procedure. If there isn't a current remote stored procedure, NULL is returned and len is set to -1.

Remarks

This function returns only the name of the remote stored procedure. It doesn't include the optional specifiers for owner, database name, and remote stored procedure number.

Since it's legal to call srv_rpcname when there isn't a remote stored procedure, (no informational error occurs), this function provides a method for determining whether a remote stored procedure exists.

See Also