PtInit()

Initialize the widget library

Synopsis:

int PtInit( char const *name );

Library:

ph

Description:

This function initializes the widget library. If no Photon channel is currently attached, this function calls PhAttach() with the given Photon server name (/net/darrin/dev/photon, for example). If there is a current channel, PhAttach() isn't called.

Once a channel is attached, PtInit() initializes all the widgets supplied by QNX Software Systems.

---

The application that calls PtInit() must have the appropriate permissions to read from and write to the attached Photon server, or the call will fail.

---

Returns:

0

Successful completion.

-1

An error occurred.

Examples:

See PtClearWidget().

Classification:

Photon

See also:

PhAttach()