Opens an existing named connection.
DWORD ppxOpenConnection ( CTAHD ctahd, char *name, PPX_HANDLE_PARMS *parms, PPXHD *ppxhd )
|
Argument |
Description |
|
ctahd |
Context handle returned by ctaCreateContext or ctaAttachContext. |
|
name |
Pointer to the name of the connection. |
|
parms |
Pointer to a PPX_HANDLE_PARMS structure. The structure is defined as follows: typedef struct Set reservation_key field to NULL. This field is not used. |
|
ppxhd |
Pointer to connection handle. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
name is either NULL or is a pointer to a string of zero length. |
|
CTAERR_NOT_FOUND |
name connection can not 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. |
ppxOpenConnection opens a named connection and returns a handle to the connection. The name of the connection was specified when creating the connection with ppxCreateConnection.
Any application can open a handle to a named connection and set a talker or add or remove listeners. Any action taken in one application will be apparent in every application accessing that connection. Destroy a named connection by calling ppxDestroyNamedConnection.
Refer to Opening a connection for more information.