bstr_error_stack_free(3) — Subroutines
Name
bstr_error_stack_free − Frees the memory allocated to an error stack.
Syntax
bstr_t_status bstr_error_stack_free (
bstr_t_private ∗stack);
Description
The bstr_error_stack_free procedure deallocates the error stack indicated by stack and frees the memory associated with it. The specified error stack can no longer be used.
Arguments
stack
access: write
The address of the error stack to be deallocated. On completion of the procedure, the location containing the address of the stack is set to NULL.
Return Values
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_COM_PC_SIZE_MISMATCH | Number of bytes requested does not match the number of bytes returned |
| BSTR_S_NORMAL | Normal successful completion |
See Also
| bstr_error_stack_allocate | # |
| bstr_error_stack_clear | # |
| bstr_error_stack_pop | # |
| bstr_error_stack_push | # |