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

 NAME

   rpc_string_free - Frees a character string allocated by the runtime

   Used by client, server, or management applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_string_free( unsigned_char_t **string,
                         unsigned32 *status );

 PARAMETERS

   Input/Output

   string
       Specifies the address of the pointer to the character string to
       free.  The value NULL is returned.

   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 code and its meaning is as follows:

       rpc_s_ok             Success.

 DESCRIPTION

   The rpc_string_free() routine deallocates the memory occupied by a
   character string returned by the RPC runtime.

   An application must call this routine once for each character string
   allocated and returned by calls to other RPC runtime routines.  The
   names of these routines appear at the end of this reference page.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: dce_error_inq_text
              rpc_binding_inq_auth_client
              rpc_binding_inq_auth_info
              rpc_binding_to_string_binding
              rpc_mgmt_ep_elt_inq_next
              rpc_mgmt_inq_server_princ_name
              rpc_ns_binding_inq_entry_name
              rpc_ns_entry_expand_name
              rpc_ns_group_mbr_inq_next
              rpc_ns_profile_elt_inq_next
              rpc_string_binding_compose
              rpc_string_binding_parse
              uuid_to_string