rpc_network_is_protseq_valid(3rpc)

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

protseq
Specifies a string identifier for a protocol sequence. (See the table of valid protocol sequences in rpc_intro(3rpc) for a list of acceptable values.)

The rpc_network_is_protseq_valid( ) routine determines whether this parameter contains a valid protocol sequence. If not, the routine returns FALSE and the status parameter contains the rpc_s_invalid_rpc_protseq status code.

Output

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

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. DCE RPC supports the protocol sequences pointed to by the explanation of the protseq parameter.

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

Return Values
This routine can return the following values:

TRUE	The RPC runtime supports the protocol sequence specified in the protseq parameter. The routine returns the status code rpc_s_ok in the status parameter.
FALSE	The RPC runtime does not support the protocol sequence specified in the protseq parameter.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

rpc_s_ok
Success.

rpc_s_invalid_rpc_protseq
Invalid protocol sequence.

rpc_s_protseq_not_supported
Protocol sequence not supported on this host.

Related Information
Functions: rpc_network_inq_protseqs(3rpc)

rpc_string_binding_parse(3rpc)