VMS Help DCE_RPC, Application Routines, rpc_if_id_vector_free  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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_vector
         Specifies the address of a pointer to a vector of interface
         information. On return the pointer is set to NULL.

   Output

   status
         Returns 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_ok  Success.

         rpc_s_invalid_arg
                   Invalid 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 parameter to NULL.

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

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_if_inq_id
              rpc_mgmt_inq_if_ids
              rpc_ns_mgmt_entry_inq_if_ids