NAME

rpc_tower_to_binding — Returns a binding handle from a tower representation

Synopsis

void rpc_tower_to_binding(
byte_p_t prot_tower,
rpc_binding_handle_t ∗binding,
unsigned32 ∗status);

Parameters

Input

prot_towerSpecifies a single protocol tower to convert to a binding handle. 

Output

bindingReturns the server binding handle. 

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

Description

The rpc_tower_to_binding() routine creates a server binding handle a canonical representation of a protocol tower. 

When an application finishes using the binding parameter, the application calls the rpc_binding_free() routine to release the memory used by the binding handle. 

The rpc_intro(3rpc) reference page contains an explanation of binding handles. 

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_arg
Invalid argument.

rpc_s_invalid_endpoint_format
Invalid endpoint format.

rpc_s_protseq_not_supported
Protocol sequence not supported on this host.

Related Information

Functions: rpc_binding_copy(3rpc), rpc_binding_free(3rpc), rpc_tower_vector_free(3rpc), rpc_tower_vector_from_binding(3rpc).