188 lines
8.1 KiB
C
188 lines
8.1 KiB
C
/*****************************************************************************\
|
|
* *
|
|
* scrnsave.h Windows NT 3.1 screensaver defines and definitions. *
|
|
* *
|
|
* Version 1.0 *
|
|
* *
|
|
* NOTE: windows.h must be #included first *
|
|
* *
|
|
* Windows NT NOTE: (Differences from Win 3.1 Screensavers) *
|
|
* *
|
|
* All Screensavers are required to have a Description string *
|
|
* of no more than 25 chars for display by the Control Panel's *
|
|
* Desktop applet. This is string 1 in the resource string *
|
|
* table of the Windows 32-bit screen saver .SCR (.EXE) file. *
|
|
* *
|
|
* Passwords for Windows NT Screen Savers are handled by the *
|
|
* Winlogon process. If the registry value: *
|
|
* *
|
|
* HKEY_CURRENT_USER\Control Panel\Desktop\ScreenSaverIsSecure *
|
|
* *
|
|
* is nonzero, Winlogon will ask for the User's login password *
|
|
* before allowing the Screen Saver to exit. All password data *
|
|
* and dialogs have been removed from individual Screensavers. *
|
|
* *
|
|
* *
|
|
* Copyright (c) 1992-1995, Microsoft Corp. All rights reserved. *
|
|
* *
|
|
\*****************************************************************************/
|
|
|
|
#ifndef _INC_SCRNSAVE
|
|
#define _INC_SCRNSAVE
|
|
|
|
#include <pshpack1.h> /* Assume byte packing throughout */
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" { /* Assume C declarations for C++ */
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
/* MANDATORY string required in .RC file
|
|
* This string should contain a less than 25 char name/description of the
|
|
* screen saver. This string is what will be seen by the user in the Control
|
|
* Panel's Desktop applet screen saver listbox.
|
|
*/
|
|
|
|
#define IDS_DESCRIPTION 1
|
|
|
|
/* Icon resource ID.
|
|
*
|
|
* This should be the first icon used and must have this resource number.
|
|
* This is needed as the first icon in the file will be grabbed
|
|
*/
|
|
#define ID_APP 100
|
|
#define DLG_SCRNSAVECONFIGURE 2003
|
|
|
|
#define idsIsPassword 1000
|
|
#define idsIniFile 1001
|
|
#define idsScreenSaver 1002
|
|
#define idsPassword 1003
|
|
#define idsDifferentPW 1004
|
|
#define idsChangePW 1005
|
|
#define idsBadOldPW 1006
|
|
#define idsAppName 1007
|
|
#define idsNoHelpMemory 1008
|
|
#define idsHelpFile 1009
|
|
#define idsDefKeyword 1010
|
|
|
|
/* This function is the Window Procedure for the screen saver. It is
|
|
* up to the programmer to handle any of the messages that wish to be
|
|
* interpretted. Any unused messages are then passed back to
|
|
* DefScreenSaverProc if desired which will take default action on any
|
|
* unprocessed message...
|
|
*/
|
|
LRESULT WINAPI ScreenSaverProc (HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam);
|
|
|
|
/* This function performs default message processing. Currently handles
|
|
* the following messages:
|
|
*
|
|
* WM_SYSCOMMAND: return FALSE if wParam is SC_SCREENSAVE or SC_CLOSE
|
|
*
|
|
* WM_DESTROY: PostQuitMessage(0)
|
|
*
|
|
* WM_SETCURSOR: By default, this will set the cursor to a null cursor,
|
|
* thereby removing it from the screen.
|
|
*
|
|
* WM_LBUTTONDOWN:
|
|
* WM_MBUTTONDOWN:
|
|
* WM_RBUTTONDOWN:
|
|
* WM_KEYDOWN:
|
|
* WM_KEYUP:
|
|
* WM_MOUSEMOVE: By default, these will cause the program to terminate.
|
|
* Unless the password option is enabled. In that case
|
|
* the DlgGetPassword() dialog box is brought up.
|
|
*
|
|
* WM_NCACTIVATE:
|
|
* WM_ACTIVATEAPP:
|
|
* WM_ACTIVATE: By default, if the wParam parameter is FALSE (signifying
|
|
* that transfer is being taken away from the application),
|
|
* then the program will terminate. Termination is
|
|
* accomplished by generating a WM_CLOSE message. This way,
|
|
* if the user sets something up in the WM_CREATE, a
|
|
* WM_DESTROY will be generated and it can be destroyed
|
|
* properly.
|
|
* This message is ignored, however is the password option
|
|
* is enabled.
|
|
*/
|
|
LRESULT WINAPI DefScreenSaverProc (HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam);
|
|
|
|
/* A function is also needed for configuring the screen saver. The function
|
|
* should be exactly like it is below and must be exported such that the
|
|
* program can use MAKEPROCINSTANCE on it and call up a dialog box. Further-
|
|
* more, the template used for the dialog must be called
|
|
* ScreenSaverConfigure to allow the main function to access it...
|
|
*/
|
|
BOOL WINAPI ScreenSaverConfigureDialog (HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam);
|
|
|
|
/* To allow the programmer the ability to register child control windows, this
|
|
* function is called prior to the creation of the dialog box. Any
|
|
* registering that is required should be done here, or return TRUE if none
|
|
* is needed...
|
|
*/
|
|
BOOL WINAPI RegisterDialogClasses (HANDLE hInst);
|
|
|
|
/* The following functions are called by DefScreenSaverProc and must
|
|
* be exported by all screensavers using this model.
|
|
*/
|
|
|
|
/*
|
|
* There are only three other points that should be of notice:
|
|
* 1) The screen saver must have a string declared as 'szAppName' contaning the
|
|
* name of the screen saver, and it must be declared as a global.
|
|
* 2) The screen saver EXE file should be renamed to a file with a SCR
|
|
* extension so that the screen saver dialog from the control panel can
|
|
* find it when is searches for screen savers.
|
|
*/
|
|
#define WS_GT (WS_GROUP | WS_TABSTOP)
|
|
|
|
#define MAXFILELEN 13
|
|
#define TITLEBARNAMELEN 40
|
|
#define APPNAMEBUFFERLEN 40
|
|
#define BUFFLEN 255
|
|
|
|
/* The following globals are defined in scrnsave.lib */
|
|
extern HANDLE hMainInstance;
|
|
extern HWND hMainWindow;
|
|
extern BOOL fChildPreview;
|
|
extern TCHAR szName[TITLEBARNAMELEN];
|
|
extern TCHAR szAppName[APPNAMEBUFFERLEN];
|
|
extern TCHAR szIniFile[MAXFILELEN];
|
|
extern TCHAR szScreenSaver[22];
|
|
extern TCHAR szHelpFile[MAXFILELEN];
|
|
extern TCHAR szNoHelpMemory[BUFFLEN];
|
|
extern UINT MyHelpMessage;
|
|
|
|
/* OPTIONAL - Win95 Only */
|
|
|
|
#define SCRM_VERIFYPW WM_APP
|
|
/*
|
|
* This message is sent to the main screen saver window when password
|
|
* protection is enabled and the user is trying to close the screen saver. You
|
|
* can process this message and provide your own validation technology. If you
|
|
* process this message, you should also support the ScreenSaverChangePassword
|
|
* function, described below. Return zero from this message if the password
|
|
* check failed. Return nonzero for success. If you run out of memory or
|
|
* encounter a similar class of error, return non-zero so the user isn't left
|
|
* out in the cold. The default action is to call the Windows Master
|
|
* Password Router to validate the user's password.
|
|
*/
|
|
|
|
void WINAPI ScreenSaverChangePassword( HWND hParent );
|
|
/*
|
|
* You supply this if you provide your own authentication. Windows will call
|
|
* it when the user wants to change the password. An implementation of this
|
|
* function should present password change UI to the user.
|
|
* You should only supply this function if you also hook the SCRM_VERIFYPW
|
|
* message to validate passwords.
|
|
* The default action is to call the Windows Master Password Router.
|
|
*/
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#include <poppack.h>
|
|
|
|
#endif /* !_INC_SCRNSAVE */
|