Table of Contents Index NMS Glossary Previous Page Next Page (Page 11 of 17 in this chapter) Version

ppxOpenConnection

Description

Opens an existing named connection.

Prototype

DWORD ppxOpenConnection ( CTAHD ctahd,
char *name,
PPX_HANDLE_PARMS *parms,
PPXHD *ppxhd )

ctahd Context handle returned by ctaCreateContext.

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

Events

Details

This function 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.

A named connection is destroyed by calling ppxDestroyNamedConnection.

The reservation_key field is currently not used, therefore should be set to NULL.

See Also

ppxCloseConnection, ppxCreateConnection, ppxDestroyNamedConnection


Table of Contents Index NMS Glossary Previous Page Next Page (Page 11 of 17 in this chapter) Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, NMS Communications Corporation. All rights reserved.