NAME

rpc_mgmt_set_server_stack_size - Specifies the stack size for each server thread

Used by server applications. 

SYNOPSIS

#include <dce/rpc.h>
void rpc_mgmt_set_server_stack_size(

unsigned32 thread_stack_size ,
unsigned32 ∗status );

PARAMETERS

Input

thread_stack_sizeSpecifies, in bytes, the stack size allocated for each thread created by the rpc_server_listen routine. This value is applied to all threads created for the server.  Select this value based on the stack requirements of the remote procedures offered by the server. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not.  The possible status codes and their meanings are as follows:

rpc_s_okSuccess. 

rpc_s_invalid_argInvalid argument. 

rpc_s_not_supported
Not supported.

DESCRIPTION

The rpc_mgmt_set_server_stack_size routine specifies the thread stack size to use when the RPC runtime creates call threads for executing remote procedure calls.  The max_calls_exec argument in the rpc_server_listen routine specifies the number of call execution threads created. 

A server, provided it knows the stack requirements of all the manager routines in the interfaces it offers, can call the rpc_mgmt_set_server_stack_size routine to ensure that each call thread has the necessary stack size. 

This routine is optional. When used, this routine must be called before the server calls the rpc_server_listen routine.  If a server does not call this routine, the default per thread stack size from the underlying threads package is used. 

Some thread packages do not support the specification or modification of thread stack sizes.  The packages cannot perform such operations or the concept of a thread stack size is meaningless to them. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_server_listen(3)