NAME

rpc_network_is_protseq_valid - Tells whether the specified protocol sequence is supported by both the RPC runtime and the operating system

Used by client and server applications. 

SYNOPSIS

#include <dce/rpc.h>
boolean32 rpc_network_is_protseq_valid(

unsigned_char_t ∗protseq ,
unsigned32 ∗status );

PARAMETERS

Input

protseqSpecifies a string identifier for a protocol sequence.  See the table of valid protocol sequences in the rpc_intro(3) reference page for a list of acceptable values.  The location of the table is in the description of a protocol sequence.  The rpc_network_is_protseq_valid routine determines whether this argument contains a valid protocol sequence.  If not, the routine returns false and the status argument contains the rpc_s_invalid_protseq status code. 

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_protseqInvalid protocol sequence. 

rpc_s_protseq_not_supported
Protocol sequence not supported on this host.

DESCRIPTION

The rpc_network_is_protseq_valid routine determines whether a specified protocol sequence is available for making remote procedure calls.  A server chooses to accept remote procedure calls over some or all of the supported protocol sequences. 

A protocol sequence is valid if the RPC runtime and the operating system support the protocol sequence.  RPC supports the protocol sequences pointed to by the explanation of argument protseq. 

An application calls the rpc_network_inq_protseqs routine to obtain all the supported protocol sequences. 

RETURN VALUES

This routine can return the following values:

trueThe RPC runtime supports the protocol sequence specified in the protseq argument.  The routine returns the status code rpc_s_ok in the status argument. 

falseThe RPC runtime does not support the protocol sequence specified in the protseq argument. 

RELATED INFORMATION

Functions: rpc_network_inq_protseqs(3), rpc_string_binding_parse(3)