WinWaitForShell

WinWaitForShell

WinWaitForShell(event)

Allows an application to wait for the Workplace Shell to become available.

Parameters

event - ULONG - input

The event being waited upon.

Constants

Constants defined for event:

• WWFS_QUERY
• WWFS_DESKTOPCREATED
• WWFS_DESKTOPOPENED
• WWFS_DESKTOPPOPULATED

Returns

Returns BOOL with the values of:

• TRUE
• FALSE

Define (C/C++)

INCL_WINWORKPLACE

Calling conversion

Cdecl32

Example Code

BOOL rc;
...
rc = WinWaitForShell(WWFS_DESKTOPPOPULATED); // Desktop populated
...

Related Functions

WinNotebookButtonFromID

Notes

When calling WinWaitForShell from detached processes, you must specify the WWFS_QUERY flag. Else the call will fail.

A message queue is not required for the thread which calls WinWaitForShell.

The prototype and defines for this function are defined in wpobject.h, which may be inaccessible if not compiling a WPS object class. Copy the defines and the prototype verbatim into your own code or headers for use. It is exported through os2386.lib in the OS/2 Warp 4 Toolkit.

OS Version Introduced

OS/2 Warp 4