IPXV_Inst::ShowMsgBoxWithOpt Method

Revision as of 06:33, 12 June 2015

The extended method to show the message box with check-option in main thread.

Syntax

HRESULT ShowMsgBoxWithOpt([in]                               BSTR       Text,
                          [in]                               BSTR       Title,
                          [in]                               BSTR       Header,
                          [in]                               BSTR       OptionText,
                          [in, out]                          LONG*      OptionState,
                          [in, defaultvalue(0)]              HANDLE_T   hWndParent,
                          [in, defaultvalue(0)]              LONG       Style,
                          [out, retval, defaultvalue(NULL)]  LONG_PTR*  Res);

Parameters

Text

[in] Text of message.

Title

[in] The title for dialog box. If empty then default application's title will be used.

Header

[in] The text of header of message.

OptionText

[in] Specifies the text for check-box control on the dialog. Setting of any non-empty text will show the check-box control.

OptionState

[in, out] Sets/gets the state of check-box on the dialog.

hWndParent

[in, defaultvalue(0)] The optional parameter that specifies the handle of parent window.

Style

[in, defaultvalue(0)] Specifies the style of message box. See UIX_MsgBoxStyleFlags.

Res

[out, retval, defaultvalue(NULL)] Returns the user's choice identifier. For possible values see UIX_MsgBoxResult.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IPXV_Inst