NAME

rpc_mgmt_inq_if_ids - Returns a vector of interface identifiers of interfaces a server offers

Used by client, server, or management applications. 

SYNOPSIS

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

rpc_binding_handle_t binding ,
rpc_if_id_vector_t ∗∗if_id_vector ,
unsigned32 ∗status );

PARAMETERS

Input

bindingSpecifies a binding handle. To receive interface identifiers from a remote application, specify a server binding handle for that application. To receive interface information about your own (local) application, specify NULL.  If the binding handle you supply refers to partially bound binding information and the binding information contains a nil object UUID, this routine returns the rpc_s_binding_incomplete status code.  In this case, the RPC daemon (RPCD) does not know which server instance to select from the local endpoint map because the RPC management interface is automatically registered (by the RPC runtime) for all RPC servers.  To avoid this situation, you can obtain a fully bound server binding handle by calling routine rpc_ep_resolve_binding. 

Output

if_id_vectorReturns the address of an 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_binding_incomplete
Binding incomplete (no object ID and no endpoint).

rpc_s_comm_failureCommunications failure. 

rpc_s_invalid_argInvalid argument. 

rpc_s_invalid_bindingInvalid binding handle. 

rpc_s_no_interfacesNo interfaces registered. 

rpc_s_not_authorizedNot authorized for operation. 

rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.

DESCRIPTION

An application calls the rpc_mgmt_inq_if_ids routine to obtain a vector of interface identifiers listing the interfaces registered by a server with the RPC runtime. 

If a server has not registered any interfaces with the runtime, this routine returns a rpc_s_no_interfaces status code and an if_id_vector argument value of NULL. 

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

By default, the RPC runtime allows all clients to remotely call this routine.  To restrict remote calls of this routine, a server application supplies an authorization function using the rpc_mgmt_set_authorization_fn routine. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_ep_resolve_binding(3), rpc_if_id_vector_free(3), rpc_mgmt_set_authorization_fn(3), rpc_server_register_if(3)