Previous section.

CDE 1.1: Remote Procedure Call
Copyright © 1997 The Open Group

NAME

rpc_network_is_protseq_valid- tells whether the specified protocol sequence is valid and/or is supported by the local implementation of the RPC run-time system and the operating system

SYNOPSIS

#include <dce/rpc.h>

boolean32 rpc_network_is_protseq_valid( unsigned_char_t *protseq, unsigned32 *status);

PARAMETERS

Input

protseq
Specifies a protocol sequence. Protocol Sequence Strings lists valid protocol sequence identifiers that may be used for this argument.

The rpc_network_is_protseq_valid() routine determines whether this argument contains a valid and/or supported protocol sequence.

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. The protocol sequence is valid and supported by the local implementation of the RPC run-time system and the operating system.

rpc_s_invalid_rpc_protseq

Invalid 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 both valid and supported and thus available for making remote procedure calls.

An application can obtain the set of valid and supported protocol sequences by calling the rpc_network_inq_protseqs() routine.

RETURN VALUE

The rpc_network_is_protseq_valid() routine returns the following values:

TRUE
The protocol sequence specified in the protseq argument is valid and supported by the RPC run-time system and the operating system. The routine also returns the status code rpc_s_ok in the status argument.

FALSE
The protocol sequence specified in the protseq argument is not valid or not supported. The routine also returns a status code not equal to rpc_s_ok.

SEE ALSO


rpc_network_inq_protseqs()
rpc_string_binding_parse().

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.

Contents Next section Index