NAME

rpc_if_id_vector_free - Frees a vector and the interface identifier structures it contains

Used by client, server, or management applications. 

SYNOPSIS

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

rpc_if_id_vector_t ∗∗if_id_vector ,
unsigned32 ∗status );

PARAMETERS

Input/Output

if_id_vectorSpecifies the address of a pointer to a vector of interface information. On return the pointer is set to NULL. 

Output

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 explanations are as follows:

rpc_s_okSuccess. 

rpc_s_invalid_argInvalid argument. 

DESCRIPTION

The rpc_if_id_vector_free routine frees the memory used to store a vector of interface identifiers.  This includes memory used by the interface identifiers and the vector itself. On return this routine sets the if_id_vector argument to NULL. 

To obtain a vector of interface identifiers, call the rpc_ns_mgmt_entry_inq_if_ids routine or the rpc_mgmt_inq_if_ids routine.  Call the rpc_if_id_vector_free routine if you have used either of these routines. 

RETURN VALUES

None. 

RELATED INFORMATION

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