IPXV_Inst::ShowMsgBoxWithOpt Method

Latest revision as of 02:57, 15 June 2015

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

Syntax

HRESULT ShowMsgBoxWithOpt([in]                               BSTR       sText,
                          [in]                               BSTR       sTitle,
                          [in]                               BSTR       sHeader,
                          [in]                               BSTR       sOptionText,
                          [in, out]                          LONG*      nOptionState,
                          [in, defaultvalue(0)]              HANDLE_T   hWndParent,
                          [in, defaultvalue(0)]              LONG       nStyle,
                          [out, retval, defaultvalue(NULL)]  LONG_PTR*  nRes);

Parameters

sText

[in] Text of message.

sTitle

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

sHeader

[in] The text of header of message.

sOptionText

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

nOptionState

[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.

nStyle

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

nRes

[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