NAME

rpc_if_inq_id — Returns the interface identifier for an interface specification;  used by client or server applications

Synopsis

void rpc_if_inq_id(
rpc_if_handle_t if_handle,
rpc_if_id_t ∗if_id,
unsigned32 ∗status);

Parameters

Input

if_handleRepresents a stub-generated data structure that specifies the interface specification to inquire about. 

Output

if_idReturns the interface identifier.  The application provides memory for the returned data. 

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

An application calls the rpc_if_inq_id() routine to obtain a copy of the interface identifier from the provided interface specification. 

The returned interface identifier consists of the interface UUID and interface version numbers (major and minor) specified in the DCE IDL file’s interface specification. 

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.

Related Information

Functions: rpc_if_id_vector_free(3rpc), rpc_mgmt_inq_if_ids(3rpc), rpc_ns_mgmt_entry_inq_if_ids(3rpc).