DlgChangePassword

3.1

  #include <scrnsave.h>    

  BOOL DlgChangePassword(hDlg, message, wParam, lParam)    
  HWND hDlg; /* handle of dialog box */
  UINT message; /* message */
  WPARAM wParam; /* first message parameter */
  LPARAM lParam; /* second message parameter */

The DlgChangePassword function receives messages from a dialog box that changes the password for a screen saver.

Parameters

hDlg

Identifies the dialog box that changes the password for a screen saver.

message

Specifies the message.

wParam

Specifies 16 bits of additional message-dependent information.

lParam

Specifies 32 bits of additional message-dependent information.

Return Value

The return value is nonzero if the function is successful; otherwise, it is zero.

Comments

This function is called by the ScreenSaverConfigureDialog function to change the password for a screen saver. An application uses the MakeProcInstance function with DlgChangePassword to display a configuration dialog box.

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 change password dialog box must use the DLG_CHANGEPASSWORD identifier (defined as 2000).

The DlgChangePassword function must be exported by including it in an EXPORTS statement in the application's module-definition (.DEF) file.

See Also

DlgGetPassword, DlgInvalidPassword, ScreenSaverConfigureDialog