| #include <scrnsave.h> |
| BOOL DlgInvalidPassword(hDlg, message, wParam, lParam) | |||||
| HWND hDlg; | /* handle of dialog box | */ | |||
| UINT message; | /* message | */ | |||
| WPARAM wParam; | /* first message parameter | */ | |||
| LPARAM lParam; | /* second message parameter | */ | |||
The DlgInvalidPassword function displays a dialog box warning that a user's password is invalid.
hDlg
Identifies the dialog box that warns that a user's password is invalid.
message
Specifies the message.
wParam
Specifies 16 bits of additional message-dependent information.
lParam
Specifies 32 bits of additional message-dependent information.
The return value is nonzero if the function is successful; otherwise, it is zero.
The DlgInvalidPassword function is provided in SCRNSAVE.LIB. Most applications provide a dialog box template and export the function without explicitly calling it in their code. This reference information for DlgInvalidPassword is provided for applications that change the default behavior.
DlgInvalidPassword is called during processing of the DlgGetPassword function when the user types an incorrect password.
A password applies to all screen savers using SCRNSAVE.LIB. Whether the password is enabled, however, is specific to a particular screen saver.
The dialog box template for the dialog box warning that the user's password is invalid must use the DLG_INVALIDPASSWORD identifier (defined as 2002).
The DlgInvalidPassword function must be exported by including it in an EXPORTS statement in the application's module-definition (.DEF) file.