Submits a series of connection calls.
DWORD ppxSubmit ( CTAHD ctahd )
|
Argument |
Description |
|
ctahd |
Context handle returned by ctaCreateContext or ctaAttachContext. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_OUT_OF_MEMORY |
Unable to allocate memory. |
|
CTAERR_SVR_COMM |
Natural Access server communication error. |
|
PPXERR_COMM_FAILURE |
Problems were encountered when communicating with the PPX server. |
|
PPXERR_INVALID_COMMAND |
A ppxBegin command was not active. |
PPXEVN_SUBMIT_COMPLETE
ppxSubmit submits a series of switching commands that are preceded with ppxBegin.
When ppxSubmit is called, the PPX service determines if each operation is valid and if valid paths exist for all connections. After verifying the commands and paths, the PPX service calls the functions to perform the operations. If an error occurs when making the connections, the system is returned to its state before ppxBegin was called.
The value field of PPXEVN_SUBMIT_COMPLETE contains either SUCCESS or the first non-SUCCESS response issued by the commands included in the ppxBegin/ppxSubmit block.
Only one begin or submit transaction can be active on a given context.
Refer to Managing groups of connections for more information.