SHMessageBoxCheckA.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

SHMessageBoxCheckA (SHLWAPI.185)

SYNOPSIS

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

DESCRIPTION

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

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

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

Debug channel "shell".