This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtConnectorCreate()

Create a connector

Synopsis:

PtConnector_t *PtConnectorCreate(
                  const char *name,
                  PtConnectorCallbackFunc_t *cb,
                  void *data );

Arguments:

name

The name to register, or NULL for a nameless connector. If name isn't NULL, it must be unique; an attempt to create a connector with a name that's already registered will fail.

cb

A callback to call for each client that connects. PtConnectorCallbackFunc_t is a function type:

typedef void PtConnectorCallbackFunc_t(
                PtConnector_t *,
                PtConnectionServer_t *, 
                void * );

The callback is called each time a new server connection object is created as a response to a connection request from a client.

data

Extra data to pass to the callback as the last argument.

Library:

ph

Description:

This function creates a connector.

Returns:

A pointer to a PtConnector_t structure that describes the connector.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No