rpc_tower_to_binding(3rpc)
Returns a binding handle from a tower representation
Synopsis
#include <dce/rpc.h>
void rpc_tower_to_binding(
byte_p_t prot_tower,
rpc_binding_handle_t *binding,
unsigned32 *status);
Parameters
Input
prot_tower
Specifies a single protocol tower to convert to a binding handle.
Output
binding
Returns the server binding handle.
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_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_tower_vector_from_binding(3rpc)