srv_rpcname

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

Important This Open Data Services function or macro is only supported in Microsoft® SQL Server™ version 7.0 for backward compatibility.

For more information about Open Data Services functions or macros supported for backward compatibility, see Open Data Services (Level 3).

Syntax

DBCHAR * srv_rpcname (
SRV_PROC * srvproc,
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). The structure contains information 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.

Because 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.