rpc_ns_binding_inq_entry_name(3) — Subroutines

NAME

rpc_ns_binding_inq_entry_name - Returns the name of an entry in the name service database from which the server binding handle came

Used by client applications.

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

bindingSpecifies a server binding handle whose entry name in the name service database is returned.

entry_name_syntaxAn integer value that specifies the syntax of returned argument entry_name. To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide the value rpc_c_ns_syntax_default.

Output

entry_nameReturns the name of the entry in the name service database in which binding was found. The returned name is a global name. Specify NULL to prevent the routine from returning this argument. When you specify this value, the client does not need to call the rpc_string_free routine.

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_incomplete_nameIncomplete name.

rpc_s_invalid_bindingInvalid binding handle.

rpc_s_invalid_name_syntaxInvalid name syntax.

rpc_s_no_entry_nameNo entry name for binding.

rpc_s_unsupported_name_syntax
Unsupported name syntax.

rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.

DESCRIPTION

The rpc_ns_binding_inq_entry_name routine returns the global name of the entry in the name service database from which a binding handle for a compatible server came.

The RPC runtime allocates memory for the string returned in the entry_name argument. Your application calls the rpc_string_free routine to deallocate that memory.

An entry name is associated only with binding handles returned from the rpc_ns_binding_import_next, rpc_ns_binding_lookup_next, and rpc_ns_binding_select routines.

If the binding handle specified in the binding argument is not returned from an entry in the name service database (for example, the binding handle is created by calling routine rpc_binding_from_string_binding), this routine returns the rpc_s_no_entry_name status code.

Permissions Required

None.

NOTE:

For this release, the RPC naming service (rpc_ns) routines are not implemented, nor is an independent naming service provided.

RETURN VALUES