PreviousNext

rpc_if_id_vector_free(3rpc)

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.

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.

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.

rpc_s_invalid_arg
Invalid argument.

Related Information
Functions: rpc_if_inq_id(3rpc)

rpc_mgmt_inq_if_ids(3rpc)

rpc_ns_mgmt_entry_inq_if_ids(3rpc)