WinWaitForShell: Difference between revisions
m Rephrased inacurate information about use in detached processes. |
More corrections re. calling from detached processes |
||
| Line 40: | Line 40: | ||
=== Notes === | === Notes === | ||
When calling [[OS2 API:WinWaitForShell|WinWaitForShell]] from | When calling [[OS2 API:WinWaitForShell|WinWaitForShell]] from processes started by a RUN= statement in config.sys, you must specify the WWFS_QUERY flag. Else the call will fail. | ||
A message queue is not required for the thread which calls [[OS2_API:WinWaitForShell|WinWaitForShell]]. | A message queue is not required for the thread which calls [[OS2_API:WinWaitForShell|WinWaitForShell]]. | ||
Revision as of 12:57, 30 May 2005
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:
Returns
Returns BOOL with the values of:
Module
Define (C/C++)
INCL_WINWORKPLACE
Export name/Ordinal
Calling conversion
Example Code
BOOL rc; ... rc = WinWaitForShell(WWFS_DESKTOPPOPULATED); // Desktop populated ...
Related Functions
Notes
When calling WinWaitForShell from processes started by a RUN= statement in config.sys, 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