rpc_ns_mgmt_entry_inq_if_ids(3rpc)
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 environment variable, 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.
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.
Errors
The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
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.
Related Information
Functions: rpc_if_id_vector_free(3rpc)