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.


Note: 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

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhAttach()