NAME

rpc_if_inq_id - Returns the interface identifier for an interface specification

Used by client or server applications. 

SYNOPSIS

#include <dce/rpc.h>
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.  The possible status codes and their meanings are as follows:

rpc_s_okSuccess. 

rpc_s_invalid_if_handle
Invalid interface handle.

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 IDL file’s interface specification. 

RETURN VALUES

None. 

RELATED INFORMATION

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