bstr_error_stack_allocate(3) — Subroutines
Name
bstr_error_stack_allocate − Allocates a data structure to be used as an error stack.
Syntax
bstr_t_status bstr_error_stack_allocate (
bstr_t_natural32 size,
bstr_t_private ∗stack);
Description
The bstr_error_stack_allocate procedure allocates an error stack of size entries and returns its address in stack. Each entry in the error stack is of the bstr_t_status type.
Arguments
size
access: read
The number of entries in the error stack. If 0 (zero) or a number less than BSTR_C_ERROR_STACK_SIZE is specified, BASEstar Open assumes the BSTR_C_ERROR_STACK_SIZE value.
stack
access: write
Returns the address of the error stack.
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 |
| BSTR_S_NO_MEMORY | Insufficient virtual memory |
See Also
| bstr_error_stack_clear | # |
| bstr_error_stack_free | # |
| bstr_error_stack_pop | # |
| bstr_error_stack_push | # |