# OLEUIBUSY

The OLEUIBUSY structure contains information that the OLE User Interface Library uses to initialize the Busy dialog box, and space for the library to return information when the dialog box is dismissed.

    typedef struct tagOLEUIBUSY
    {
    // These IN fields are standard across all OLEUI dialog box functions.
        DWORD          cbStruct;
        DWORD          dwFlags;
        HWND           hWndOwner;
        LPCSTR         lpszCaption;
        LPFNOLEUIHOOK  lpfnHook;
        LPARAM         lCustData;
        HINSTANCE      hInstance;
        LPCSTR         lpszTemplate;
        HRSRC          hResource;

    // Specifics for OLEUIBUSY.
        HTASK  hTask;
        HWND FAR *  lphWndDialog;
    } OLEUICHANGEICON, *POLEUICHANGEICON, FAR *LPOLEUICHANGEICON;

Members

cbStruct
  Size of the structure in bytes. This field must be filled on input.
dwFlags
  On input, specifies the initialization and creation flags. On exit, it specifies the user’s choices. It may be a combination of the following flags:
  BZ_DISABLECANCELBUTTON
    Input only: This flag disables the Cancel button.
  BZ_DISABLESWITCHTOBUTTON
    Input only: This flag disables the Switch To... button.
  BZ_DISABLERETRYBUTTON
    Input only: This flag disables the Retry button.
  BZ_NOTRESPONDINGDIALOG
    Input only: This flag generates a Not Responding dialog box instead of a Busy dialog box. The text is slightly different, and the Cancel button is disabled.
hWndOwner
  Window that owns the dialog box. It should not be NULL.
lpszCaption
  Pointer to a string to be used as the title of the dialog box. If NULL, then the library uses Busy.
lpfnHook
  Pointer to a hook function that processes messages intended for the dialog box. The hook function must return zero to pass a message that it didn’t process back to the dialog box procedure in the library. The hook function must return a non-zero value to prevent the library’s dialog box procedure from processing a message it has already processed.
lCustData
  Application-defined data that the library passes to the hook function pointed to by the lpfnHook member. The library passes a pointer to the OLEUIBUSY structure in the lParam parameter of the WM_INITDIALOG message; this pointer can be used to retrieve the lCustData member.
hInstance
  Instance that contains a dialog box template specified by the lpTemplateName member.
lpszTemplate
  Pointer to a null-terminated string that specifies the name of the resource file for the dialog box template that is to be substituted for the library’s Busy dialog box template.
hResource
  Customized template handle.
hTask Input only:
  Handle to the task that is blocking.
lphWndDialog
  Pointer to the dialog box’s HWND.

See Also

OleUIBusy