# ppxOpenConnection

Opens an existing named connection.

#### Prototype

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 { DWORD size; BYTE default_pattern; DWORD *reservation_key; } PPX_HANDLE_PARMS Set reservation_key field to NULL. This field is not used.
ppxhd | Pointer to connection handle.

#### Return values

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.

#### Details

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.

#### See also

ppxCloseConnection