srv_rpcoptions (Extended Stored Procedure API)

Applies to: yesSQL Server (all supported versions)

Important

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use CLR integration instead.

Returns run-time options for the current remote stored procedure.

Syntax

  
DBUSMALLINT srv_rpcoptions ( SRV_PROC *  
srvproc   
);  

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 Extended Stored Procedure API library uses to manage communication and data between the application and the client.

Returns

A bitmap that contains the run-time flags joined in a logical OR for the current remote stored procedure. If there is not a current remote stored procedure, 0 is returned and a message is generated.

Remarks

The following table describes each run-time flag.

Run-time flag Description
SRV_NOMETADATA The client has requested results without metadata information. This flag is only used when the client is communicating with an instance of Microsoft SQL Server. An Extended Stored Procedure API application cannot omit metadata information.
SRV_RECOMPILE The client has requested to recompile the remote stored procedure before executing it. This flag may not apply to an Extended Stored Procedure API application.

Important

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.