NAME

rpc_ns_mgmt_entry_inq_if_ids- returns the list of interface IDs exported to an entry in the name service database

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

Specifies the syntax of argument entry_name. (See Name Syntax Constants for the possible values of this argument.)

An application can supply the value rpc_c_ns_syntax_default to use the syntax specified by the RPC_DEFAULT_ENTRY_SYNTAX environment variable.

entry_name

Specifies the entry in the name service database for which an interface identifier vector is returned. The entry name must conform to the syntax specified by entry_name_syntax.

Output

if_id_vec

Returns the interface identifier vector.

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_entry_not_found

Name service entry not found.

rpc_s_name_service_unavailable

Name service unavailable.

rpc_s_no_interfaces_exported

No interfaces were exported to the 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 that contains interface IDs from the binding information in a name service entry. This routine returns binding information from the specified entry only; it does not search any profile or group members contained in the specified entry.

In implementations that cache name service data, this routine always gets its returned data directly from the name service, updating any local cache.

Applications must call rpc_if_id_vector_free() to free the memory used by the returned if_id_vec.

Permissions Required

The application needs read permission to the target name service entry.

RETURN VALUE

None.

SEE ALSO

rpc_if_id_vector_free()
rpc_if_inq_id()
rpc_ns_binding_export().

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.