bstr_enbox_disconnect(3) — Subroutines

Name

bstr_enbox_disconnect − Disconnects the application from an Enbox. (VODB only)

Syntax

bstr_t_status   bstr_enbox_disconnect (
                                  bstr_t_reference ∗enbox,
                                  bstr_t_rcb        ∗control);

Description

The bstr_enbox_disconnect procedure disconnects the specified enbox from the calling application, thus allowing another user to connect to it. Execution of this procedure on a user buffering Enbox causes any pending notifications to be discarded.

All the non-blocking requests pending on the disconnected Enbox are forced to terminate and the associated callback routine (if any) is executed for each of them. Requests that have been forced to terminate return the BSTR_S_ABORTED status code.

Arguments

enbox
access: read
The reference to the Enbox to be disconnected.

control
access: read
The address of an optional request control block.

Return Values

BSTR_S_ABORTED	Operation aborted
BSTR_S_BAD_PARAMETER	Bad parameter value
BSTR_S_BAD_REFERENCE	Bad reference
BSTR_S_COMMUNICATION_ERROR	Communication error
BSTR_S_COM_PC_SIZE_MISMATCH	Number of bytes requested does not match the number of bytes returned
BSTR_S_FINISH	Request aborted by bstr_finish
BSTR_S_INTERNAL_ERROR	Internal error
BSTR_S_INTR	Operation interrupted
BSTR_S_INVALID_OPERATION	Invalid operation
BSTR_S_INVALID_RCB	Invalid Request Control Block
BSTR_S_INVALID_USAGE	Invalid reference usage
BSTR_S_NORMAL	Normal successful completion
BSTR_S_NOT_IMPLEMENTED	Not yet implemented
BSTR_S_NOT_INITIALIZED	BASEstar Open not initialized
BSTR_S_NO_MEMORY	Insufficient virtual memory
BSTR_S_SERVER_NOT_REACHABLE	Server not reachable
BSTR_S_TIMEOUT	Timeout expired
BSTR_S_TOO_MANY_REQUESTS	Too many pending requests