NAME

rpc_ns_mgmt_entry_inq_if_ids - Returns the list of interfaces exported to an entry in the name service database

Used by client, server, or management applications. 

SYNOPSIS

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

unsigned32 entry_name_syntax ,
unsigned_char_t ∗entry_name ,
rpc_if_id_vector_t ∗∗if_id_vec ,
unsigned32 ∗status );

PARAMETERS

Input

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

entry_nameSpecifies the entry in the name service database for which an interface identifier vector is returned.  This can be either the global or cell-relative name. 

Output

if_id_vecReturns the address of the interface identifier vector. 

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_entry_not_foundName service entry not found. 

rpc_s_incomplete_nameIncomplete name. 

rpc_s_invalid_name_syntaxInvalid name syntax. 

rpc_s_name_service_unavailable
Name service unavailable.

rpc_s_no_interfaces_exported
No interfaces were exported to entry.

rpc_s_no_ns_permissionNo permission for name service operation. 

rpc_s_unsupported_name_syntax
Unsupported name syntax.

DESCRIPTION

The rpc_ns_mgmt_entry_inq_if_ids routine returns an interface identifier vector containing the interfaces of binding handles exported to argument entry_name. 

This routine uses an expiration age of 0 (zero) to cause an immediate update of the local copy of name service data.  The description of the rpc_ns_mgmt_inq_exp_age routine contains an explanation of the expiration age. 

The application calls the rpc_if_id_vector_free routine to release memory used by the returned vector. 

Permissions Required

You need read permission to the CDS object entry (the target name service entry). 

NOTE:

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

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_if_id_vector_free(3), rpc_if_inq_id(3), rpc_ns_binding_export(3)