rpc_binding_to_string_binding(3rpc)
Returns a string representation of a binding handle
Used by client, server, or management applications.
Synopsis
#include <dce/rpc.h>
void rpc_binding_to_string_binding(
rpc_binding_handle_t binding,
unsigned_char_t **string_binding,
unsigned32 *status);
Parameters
Input
binding
Specifies a client or server binding handle to convert to a string representation of a binding handle.
Output
string_binding
Returns a pointer to the string representation of the binding handle specified in the binding parameter.
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_to_string_binding( ) routine converts a client or server binding handle to its string representation.
The RPC runtime allocates memory for the string returned in the string_binding parameter. The application calls the rpc_string_free( ) routine to deallocate that memory.
If the binding handle in the binding parameter contains a nil object UUID, the object UUID field is not included in the returned string.
To parse the returned string_binding parameter, call rpc_string_binding_parse( ).
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_cant_getpeername
Cannot get peer name.
rpc_s_connection_closed
Connection closed.
rpc_s_invalid_binding
Invalid binding handle.
Related Information
Functions: rpc_binding_from_string_binding(3rpc)
rpc_string_binding_parse(3rpc)