bstr_port_disconnect(3) — Subroutines

Name

bstr_port_disconnect − Disconnects the application from a Port (VODB only).

Syntax

bstr_t_status   bstr_port_disconnect (
                                  bstr_t_reference ∗port,
                                  bstr_t_rcb        ∗control);

Description

The bstr_port_disconnect procedure disconnects the specified Port from the calling application, thus allowing another user to connect to it.

Execution of this procedure on a USER_BUFFERING Port causes any pending Packet notifications to be discarded.

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

Arguments

port
access: read
The reference to the Port 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