NAME

rpc_server_use_protseq- tells the RPC run-time system to use the specified protocol sequence for receiving remote procedure calls

SYNOPSIS

#include <dce/rpc.h>

void rpc_server_use_protseq(
	unsigned_char_t *protseq,
	unsigned32 max_call_requests,
	unsigned32 *status);

PARAMETERS

Input

protseq

Specifies a protocol sequence to register with the RPC run-time system. Protocol Sequence Strings lists valid protocol sequence identifiers that may be used for this argument.

max_call_requests

Specifies the number of concurrent remote procedure call requests that the server is guaranteed to accept from the transport. The RPC run-time system allocates sufficient network resources to handle this number of concurrent calls.

The RPC run-time system guarantees that the server can accept at least this number of concurrent call requests. The actual number of these requests can be greater than the value of max_call_requests and can vary for each protocol sequence.

The value rpc_c_protseq_max_reqs_default specifies an implementation-dependent default value >=1.

Note:

The rpc_server_listen() routine specifies a max_calls_exec argument that specifies the number of call threads the server will allocate to handle calls. Normally, the values of max_calls_exec and max_call_requests are the same. Servers are guaranteed to support the minimum of max_calls_exec and max_call_requests concurrent remote procedure calls. Applications should not rely on a server handling more than this number.

Output

status

Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_protseq_not_supported

Protocol sequence not supported on this host.

DESCRIPTION

The rpc_server_use_protseq() routine registers a single protocol sequence with the RPC run-time system. A server must register at least one protocol sequence with the RPC run-time system to receive remote procedure call requests. A server can call this routine multiple times to register additional protocol sequences.

The max_call_requests argument allows an application to specify the number of concurrent remote procedure call requests the server is guaranteed to handle.

Note:

To register all stub-defined protocol sequences, a server calls the rpc_server_use_all_protseqs() routine.

For a list of routines typically called after rpc_server_use_protseq(), see tagmref_rpc_server_use_all_protseqs .

RETURN VALUE

None.

SEE ALSO

rpc_binding_vector_free()
rpc_ep_register()
rpc_ep_register_no_replace()
rpc_network_is_protseq_valid()
rpc_ns_binding_export()
rpc_server_inq_bindings()
rpc_server_listen()
rpc_server_register_if()
rpc_server_use_all_protseqs_if()
rpc_server_use_all_protseqs()
rpc_server_use_protseq_ep()
rpc_server_use_protseq_if().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.