PK_MEMORY_free

PK_ERROR_code_t PK_MEMORY_free
(
--- received arguments ---
void           *pointer            --- pointer to allocated memory
)


This function frees previously allocated memory.


If the application has registered a free function, this will be used to free
the memory. If there is a registered thread-specific free function, this will
be used in preference to a registered session-wide free function.

The application supplied error handler will not be called if the function is
passed a NULL address to free, however it will return an error code of
PK_ERROR_null_arg_address for the function value.

Failing PK functions will never leave unused memory allocated for the
application to free. In general, the value of any return argument from a
failing PK function is not defined. Hence, the application must not try to
free non-NULL memory addresses returned from failing PK functions.