TechNet
Export (0) Print
Expand All
Collapse the table of content
Expand the table of content
Expand Minimize

srv_parammaxlen (Extended Stored Procedure API)

 
System_CAPS_ICON_important.jpg Important


This feature will be removed in a future version of Microsoft SQL Server. Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible. Use CLR integration instead.

Returns the maximum data length of a remote stored procedure call parameter. This function has been superseded by the srv_paraminfo function.

  
int srv_parammaxlen (  
SRV_PROC *  
srvproc  
,  
int  
n   
);  

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.

The maximum length, in bytes, of the parameter data. If there is no nth parameter or if there is no remote stored procedure, it returns -1.

This function returns the following values, if the parameter is one of the following Microsoft SQL Server data types.

New data typesInput data length
BITNNULL: 1

 ZERO: 1

 >=255: N/A

 <255: N/A
BIGVARCHARNULL: 255

 ZERO: 255

 >=255: 255

 <255: 255
BIGCHARNULL: 255

 ZERO: 255

 >=255: 255

 <255: 255
BIGBINARYNULL: 255

 ZERO: 255

 >=255: 255

 <255: 255
BIGVARBINARYNULL: 255

 ZERO: 255

 >=255: 255

 <255: 255
NCHARNULL: 255

 ZERO: 255

 >=255: 255

 <255: 255
NVARCHARNULL: 255

 ZERO: 255

 >=255: 255

 <255: 255
NTEXTNULL: -1

 ZERO: -1

 >=255: -1

 <255: -1

Each remote stored procedure parameter has an actual and a maximum data length. For standard fixed-length data types that do not allow null values, the actual and maximum lengths are the same. For variable-length data types, the lengths can vary. For example, a parameter declared as varchar(30) can have data that is only 10 bytes long. The parameter's actual length is 10 and its maximum length is 30. The srv_parammaxlen function gets the maximum data length of a remote stored procedure. To obtain the actual length of a parameter, use srv_paramlen.

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.

System_CAPS_ICON_important.jpg 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.

srv_paraminfo (Extended Stored Procedure API)
srv_rpcparams (Extended Stored Procedure API)

Community Additions

ADD
Show:
© 2016 Microsoft