NAME

rpc_binding_inq_object — Returns the object UUID from a binding handle;  used by client or server applications

Synopsis

void rpc_binding_inq_object(
rpc_binding_handle_t binding,
uuid_t ∗object_uuid,
unsigned32 ∗status);

Parameters

Input

bindingSpecifies a client or server binding handle. 

Output

object_uuid
Returns the object UUID found in the binding parameter.  The object UUID is a unique identifier for an object for which a remote procedure call can be made. 

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

Description

The rpc_binding_inq_object() routine obtains the object UUID associated with a client or server binding handle.  If no object UUID has been associated with the binding handle, this routine returns a nil UUID. 

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.

Related Information

Functions: rpc_binding_set_object(3rpc).