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

# SHMessageBoxCheckExA(3w)

## NAME

**SHMessageBoxCheckExA** (SHLWAPI.291)

## SYNOPSIS

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

*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)](/GetProcAddress/3w.md)** to obtain a pointer to the function.

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

Debug channel **"shell"**.