rpc_ns_binding_inq_entry_name- returns the name of the name service database entry that contains a given binding handle
#include <dce/rpc.h>
void rpc_ns_binding_inq_entry_name( rpc_binding_handle_t binding, unsigned32 entry_name_syntax, unsigned_char_t **entry_name, unsigned32 *status);
Input
- binding
- Specifies a server binding handle whose entry name in the name service database is returned.
- entry_name_syntax
- An integer value that specifies the syntax of the returned entry_name. (See
Name Syntax Constants for information about values of this argument.)To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, the application provides the value rpc_c_ns_syntax_default.
Output
- entry_name
- Returns the name of the entry in the name service database in which binding was found. The returned name conforms to the specified syntax.
- status
- Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.
Possible status codes and their meanings include:
- rpc_s_ok
- Success.
- rpc_s_no_entry_name
No entry name for binding.
- rpc_s_unsupported_name_syntax
Unsupported name syntax.
The rpc_ns_binding_inq_entry_name() routine returns the name of the name service database entry that contains a binding handle for a compatible server.The RPC run-time system allocates memory for the string returned in entry_name. The application calls the rpc_string_free() routine to deallocate this memory.
The binding argument must come from a call to one of the rpc_ns_binding_import_next(), rpc_ns_binding_lookup_next() or rpc_ns_binding_select() routines.
When the binding handle specified in the binding argument is not from an entry in the name service database, this routine returns the rpc_s_no_entry_name status code.
Permissions Required
None.
None.
rpc_binding_from_string_binding()
rpc_ns_binding_import_next()
rpc_ns_binding_lookup_next()
rpc_ns_binding_select()
rpc_string_free().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.
Contents | Next section | Index |