MailOpenNotify

The MailOpenNotify function attempts to open the mail database and specify a window handle to receive DB_CEOID_* notifications of changes made to the database by different handles.

Syntax

BOOL MailOpenNotify (HANDLE * phMail, BOOL fAllowCreate, HWND hwndNotify);

At a Glance

Header file: Msgstore.h
Platforms: H/PC
Versions: 2.0 and later

Parameters

phMail
Out parameter to receive the mail handle. This handle is set even if the function fails, so that the MailError function can be called against the returned handle to obtain the specific error message.
fAllowCreate
If TRUE, the database will be created if it does not already exist. If FALSE, the call fails when the specified database cannot be opened.
hwndNotify
The window handle to receive DB_CEOID_* notifications of changed made to the database via other handles.

Return Values

The function return TRUE if the database is opened and ready to use, FALSE otherwise.