SHMessageBoxCheckExA(3w)

Usage

INT_PTR SHMessageBoxCheckExA
(
HWND hWnd,
HINSTANCE hInst,
LPCSTR lpszName,
DLGPROC dlgProc,
LPARAM lParam,
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.

hInst [In] Instance of the module holding the dialogue resource.

lpszName [In] Resource Id of the dialogue resource.

dlgProc [In] Dialog procedure, or NULL for default handling.

lParam [In] LPARAM to pass to dlgProc.

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.

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

Notes

Both lpszName and lpszId must be less than MAX_PATH in length.

Implementation

Exported by ordinal only. Use GetProcAddress(3w) to obtain a pointer to the function.

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

Debug channel "shell".

Releases

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