WinWaitForShell is used by an application when it needs to wait for the Workplace Shell to be available in order for the application to continue. The application can use WinWaitForShell to wait for the Workplace Shell to be ready to start receiving the create requests. By using the optional query bit, it can check on those conditions without waiting on them.

For example, the application might be started in STARTUP.CMD, and yet it wants to create objects on the Workplace Shell.

It can wait on one of three events:

• The desktop object has been created.
  
• The desktop object has been opened.
  
• The desktop object is fully populated.