PreviousNext

rpc_binding_inq_object(3rpc)

Returns the object UUID from a binding handle

Used by client or server applications.

Synopsis

#include <dce/rpc.h>

void rpc_binding_inq_object(

rpc_binding_handle_t binding,

uuid_t *object_uuid,

unsigned32 *status);

Parameters

Input

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

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_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)