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

 NAME

   rpc_binding_set_object - Sets the object UUID value into a server
                            binding handle.

   Used by client applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_binding_set_object( rpc_binding_handle_t binding,
                                uuid_t *object_uuid,
                                unsigned32 *status );

 PARAMETERS

   Input

   binding
       Specifies the server binding into which parameter object_uuid is
       set.  Supply NULL to specify a nil UUID for this parameter.

   object_uuid
       Specifies the UUID of the object serviced by the server specified
       in the binding parameter. The object UUID is a unique identifier
       for an object for which a remote procedure call can be made.

   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_binding
                     Invalid binding handle.

       rpc_s_wrong_kind_of_binding
                     Wrong kind of binding for operation.

 DESCRIPTION

   The rpc_binding_set_object() routine associates an object UUID with
   a server binding handle. This operation replaces the previously
   associated object UUID with the UUID in the object_uuid parameter.

   To set the object UUID to the nil UUID, specify NULL or the nil UUID
   for the object_uuid parameter.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_binding_from_string_binding
              rpc_binding_inq_object