VMS Help DCE_RPC, Application Routines, rpc_ns_mgmt_entry_inq_if_ids  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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_syntax
       An integer value that specifies the syntax of argument entry_name.
       To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX logical
       name, provide rpc_c_ns_syntax_default.

   entry_name
       Specifies 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_vec
       Returns the address of the interface identifier vector.

   status
       Returns the status code from this routine, indicating whether the
       routine completed successfully or, if not, why not.

       The possible status codes and their meanings are as follows:

       rpc_s_ok       Success.

       rpc_s_entry_not_found
                      Name service entry not found.

       rpc_s_incomplete_name
                      Incomplete name.

       rpc_s_invalid_name_syntax
                      Invalid 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_permission
                      No 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
   rpc_ns_mgmt_inq_exp_age() routine's reference page contains an
   explanation of the expiration age.

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

   Permissions Required

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

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_if_id_vector_free
              rpc_if_inq_id
              rpc_ns_binding_export