---
name: "SHMessageBoxCheckA"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/SHMessageBoxCheckA"
---

# SHMessageBoxCheckA(3w)

## 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

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

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

Debug channel **"shell"**.
