PreviousNext

rpc_binding_set_object(3rpc)

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.

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.

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

rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.

Related Information
Functions: rpc_binding_from_string_binding(3rpc)

rpc_binding_inq_object(3rpc)