SHMessageBoxCheckA(3w)

SHMessageBoxCheckA3w

Usage

INT_PTR SHMessageBoxCheckA
(
HWND hWnd,
LPCSTR lpszText,
LPCSTR lpszTitle,
DWORD dwType,
INT_PTR iRet,
LPCSTR lpszId
)

Overview

Pop up a 'Don't show this message again' dialogue box.

Params

hWnd [In] Window to be the dialogues' parent.

lpszText [In] Text of the message to show.

lpszTitle [In] Title of the dialogue box.

dwType [In] Type of dialogue buttons (See below).

iRet [In] Value to return if dialogue is not shown.

lpszId [In] Name of registry subkey which determines whether to show the dialog.

Returns

Success: The value returned from the dialogue procedure (e.g. IDOK).

Failure: iRet, if the default dialogue resource could not be loaded or the dialogue should not be shown.

Notes

- Both lpszTitle and lpszId must be less than MAX_PATH in length.

- Possible values for dwType are:

Value Buttons

----- -------

0 OK

1 OK/Cancel

2 Yes/No

Implementation

Not declared in a Wine header. The function is either undocumented, or missing from Wine.

Implemented in "dlls/shlwapi/msgbox.c".

Debug channel "shell".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.