NAME

rpc_ns_binding_inq_entry_name- returns the name of the name service database entry that contains a given binding handle

SYNOPSIS

#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);

PARAMETERS

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.

DESCRIPTION

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.

RETURN VALUE

None.

SEE ALSO

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.