VMS Help DCE_RPC, Application Routines, rpc_network_is_protseq_valid  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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

   protseq
       Specifies a string identifier for a protocol sequence.  (See the
       table of valid protocol sequences in the rpc_intro reference page
       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.  The possible status codes and their meanings
       are as follows:

       rpc_s_ok      Success.

       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 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.

 RELATED INFORMATION

   Functions: rpc_network_inq_protseqs
              rpc_string_binding_parse