IPXV_Inst::ShowMsgBoxWithOpt Method

Revision as of 17:03, 26 May 2015

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

Syntax

HRESULT ShowMsgBoxWithOpt([in]                               BSTR       pText,
                          [in]                               BSTR       pTitle,
                          [in]                               BSTR       pHeader,
                          [in]                               BSTR       pOptionText,
                          [in, out]                          LONG*      pOptionState,
                          [in, defaultvalue(0)]              HANDLE_T   hWndParent,
                          [in, defaultvalue(0)]              LONG       nStyle,
                          [out, retval, defaultvalue(NULL)]  LONG_PTR*  pRes);

Parameters

pText

[in] Text of message.

pTitle

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

pHeader

[in] The text of header of message.

pOptionText

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

pOptionState

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

pRes

[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