Frees all resources and disables outputs to all points for a named connection.
DWORD ppxDestroyNamedConnection ( PPXHD ppxhd )
|
Argument |
Description |
|
ppxhd |
PPX connection handle. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_INVALID_HANDLE |
ppxhd is not a valid connection handle. |
|
CTAERR_NOT_FOUND |
Name of the connection (referenced through ppxhd) cannot be found in the PPX connection database. |
|
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. |
ppxDestroyNamedConnection frees all resources and disables outputs to all points on a named connection. Once destroyed, all open handles to the named connection become invalid in all applications. Refer to Destroying a named connection and Terminating a PPX client for more information.