NAME

rpc_binding_from_string_binding - Returns a binding handle from a string representation of a binding handle

Used by client or management applications. 

SYNOPSIS

#include <dce/rpc.h>
void rpc_binding_from_string_binding(

unsigned_char_t ∗string_binding ,
rpc_binding_handle_t ∗binding ,
unsigned32 ∗status );

PARAMETERS

Input

string_bindingSpecifies a string representation of 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.  The possible status codes and their meanings are as follows:

rpc_s_okSuccess. 

rpc_s_invalid_argInvalid argument. 

rpc_s_invalid_endpoint_format
Invalid endpoint format.

rpc_s_invalid_naf_idInvalid network address family ID. 

rpc_s_inval_net_addrInvalid network address. 

rpc_s_invalid_rpc_protseqInvalid protocol sequence. 

rpc_s_invalid_string_binding
Invalid string binding.

rpc_s_protseq_not_supported
Protocol sequence not supported on this host.

rpc_s_string_too_longString too long. 

uuid_s_bad_versionBad UUID version. 

uuid_s_invalid_string_uuidInvalid format for a string UUID. 

DESCRIPTION

The rpc_binding_from_string_binding routine creates a server binding handle from a string representation of a binding handle. 

The string_binding argument does not need to contain an object UUID. In this case, the returned binding contains a nil UUID. 

If the provided string_binding argument does not contain an endpoint field, the returned binding argument is a partially bound server binding handle. 

If the provided string_binding argument does contain an endpoint field, the returned binding argument is a fully bound server binding handle with a well-known endpoint. 

If the provided string_binding argument does not contain a host address field, the returned binding argument refers to the local host. 

To create a string binding, call the rpc_string_binding_compose routine or provide a character string constant. 

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

The rpc_intro(3) reference page contains an explanation of partially and fully bound binding handles. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_binding_copy(3), rpc_binding_free(3), rpc_binding_to_string_binding(3), rpc_string_binding_compose(3)