Name

dce_server_use_protseq - Tells DCE to use the specified protocol sequence for receiving RPCs

Synopsis

#include <dce/dced.h> void dce_server_use_protseq(
dce_server_handle_t server_handle,
unsigned char ∗protseq,
error_status_t ∗status);

Parameters

Input

server_handle
An opaque handle.  Use the value of NULL.

protseqSpecifies a string identifier for the protocol sequence to register with the RPC runtime.  (For a list of string identifiers, see the table of valid protocol sequences in the intro(3rpc) reference page.) 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully.  The only status code is error_status_ok. 

Description

The dce_server_use_protseq() routine registers an individual protocol sequence with DCE.  Typical servers use all valid protocol sequences, the default behavior for the dce_server_register() call, and so most servers do not need to call this dce_server_use_protseq() routine.  However, this routine may be called prior to dce_server_register(), to restrict the protocol sequences used.  A server must register at least one protocol sequence with the RPC runtime to receive remote procedure call requests.  A server can call this routine multiple times to register additional protocol sequences. 

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

Related Information

Functions: dce_server_register(3dce), rpc_intro(3rpc), rpc_server_use_protseq(3rpc). 

Books: OSF DCE Application Development Guide.