plink: updated to revision 10170 of putty

1 files changed, 555 insertions, 559 deletions

diff --git a/tools/plink/winstuff.h b/tools/plink/winstuff.h
index d2d65a47f..8f5e0dff0 100644
--- a/tools/plink/winstuff.h
+++ b/tools/plink/winstuff.h
@@ -1,559 +1,555 @@
-/*

- * winstuff.h: Windows-specific inter-module stuff.

- */

-

-#ifndef PUTTY_WINSTUFF_H

-#define PUTTY_WINSTUFF_H

-

-#ifndef AUTO_WINSOCK

-#include <winsock2.h>

-#endif

-#include <windows.h>

-#include <stdio.h>		       /* for FILENAME_MAX */

-

-#include "tree234.h"

-

-#include "winhelp.h"

-

-struct Filename {

-    char *path;

-};

-#define f_open(filename, mode, isprivate) ( fopen((filename)->path, (mode)) )

-

-struct FontSpec {

-    char *name;

-    int isbold;

-    int height;

-    int charset;

-};

-struct FontSpec *fontspec_new(const char *name,

-                               int bold, int height, int charset);

-

-#ifndef CLEARTYPE_QUALITY

-#define CLEARTYPE_QUALITY 5

-#endif

-#define FONT_QUALITY(fq) ( \

-    (fq) == FQ_DEFAULT ? DEFAULT_QUALITY : \

-    (fq) == FQ_ANTIALIASED ? ANTIALIASED_QUALITY : \

-    (fq) == FQ_NONANTIALIASED ? NONANTIALIASED_QUALITY : \

-    CLEARTYPE_QUALITY)

-

-#define PLATFORM_IS_UTF16 /* enable UTF-16 processing when exchanging

-			   * wchar_t strings with environment */

-

-/*

- * Where we can, we use GetWindowLongPtr and friends because they're

- * more useful on 64-bit platforms, but they're a relatively recent

- * innovation, missing from VC++ 6 and older MinGW.  Degrade nicely.

- * (NB that on some systems, some of these things are available but

- * not others...)

- */

-

-#ifndef GCLP_HCURSOR

-/* GetClassLongPtr and friends */

-#undef  GetClassLongPtr

-#define GetClassLongPtr GetClassLong

-#undef  SetClassLongPtr

-#define SetClassLongPtr SetClassLong

-#define GCLP_HCURSOR GCL_HCURSOR

-/* GetWindowLongPtr and friends */

-#undef  GetWindowLongPtr

-#define GetWindowLongPtr GetWindowLong

-#undef  SetWindowLongPtr

-#define SetWindowLongPtr SetWindowLong

-#undef  GWLP_USERDATA

-#define GWLP_USERDATA GWL_USERDATA

-#undef  DWLP_MSGRESULT

-#define DWLP_MSGRESULT DWL_MSGRESULT

-/* Since we've clobbered the above functions, we should clobber the

- * associated type regardless of whether it's defined. */

-#undef LONG_PTR

-#define LONG_PTR LONG

-#endif

-

-#define BOXFLAGS DLGWINDOWEXTRA

-#define BOXRESULT (DLGWINDOWEXTRA + sizeof(LONG_PTR))

-#define DF_END 0x0001

-

-/*

- * Dynamically linked functions. These come in two flavours:

- *

- *  - GET_WINDOWS_FUNCTION does not expose "name" to the preprocessor,

- *    so will always dynamically link against exactly what is specified

- *    in "name". If you're not sure, use this one.

- *

- *  - GET_WINDOWS_FUNCTION_PP allows "name" to be redirected via

- *    preprocessor definitions like "#define foo bar"; this is principally

- *    intended for the ANSI/Unicode DoSomething/DoSomethingA/DoSomethingW.

- *    If your function has an argument of type "LPTSTR" or similar, this

- *    is the variant to use.

- *    (However, it can't always be used, as it trips over more complicated

- *    macro trickery such as the WspiapiGetAddrInfo wrapper for getaddrinfo.)

- *

- * (DECL_WINDOWS_FUNCTION works with both these variants.)

- */

-#define DECL_WINDOWS_FUNCTION(linkage, rettype, name, params) \

-    typedef rettype (WINAPI *t_##name) params; \

-    linkage t_##name p_##name

-#define STR1(x) #x

-#define STR(x) STR1(x)

-#define GET_WINDOWS_FUNCTION_PP(module, name) \

-    (p_##name = module ? (t_##name) GetProcAddress(module, STR(name)) : NULL)

-#define GET_WINDOWS_FUNCTION(module, name) \

-    (p_##name = module ? (t_##name) GetProcAddress(module, #name) : NULL)

-

-/*

- * Global variables. Most modules declare these `extern', but

- * window.c will do `#define PUTTY_DO_GLOBALS' before including this

- * module, and so will get them properly defined.

-*/

-#ifndef GLOBAL

-#ifdef PUTTY_DO_GLOBALS

-#define GLOBAL

-#else

-#define GLOBAL extern

-#endif

-#endif

-

-#ifndef DONE_TYPEDEFS

-#define DONE_TYPEDEFS

-typedef struct conf_tag Conf;

-typedef struct backend_tag Backend;

-typedef struct terminal_tag Terminal;

-#endif

-

-#define PUTTY_REG_POS "Software\\SimonTatham\\PuTTY"

-#define PUTTY_REG_PARENT "Software\\SimonTatham"

-#define PUTTY_REG_PARENT_CHILD "PuTTY"

-#define PUTTY_REG_GPARENT "Software"

-#define PUTTY_REG_GPARENT_CHILD "SimonTatham"

-

-/* Result values for the jumplist registry functions. */

-#define JUMPLISTREG_OK 0

-#define JUMPLISTREG_ERROR_INVALID_PARAMETER 1

-#define JUMPLISTREG_ERROR_KEYOPENCREATE_FAILURE 2

-#define JUMPLISTREG_ERROR_VALUEREAD_FAILURE 3

-#define JUMPLISTREG_ERROR_VALUEWRITE_FAILURE 4

-#define JUMPLISTREG_ERROR_INVALID_VALUE 5

-

-#define PUTTY_HELP_FILE "putty.hlp"

-#define PUTTY_CHM_FILE "putty.chm"

-#define PUTTY_HELP_CONTENTS "putty.cnt"

-

-#define GETTICKCOUNT GetTickCount

-#define CURSORBLINK GetCaretBlinkTime()

-#define TICKSPERSEC 1000	       /* GetTickCount returns milliseconds */

-

-#define DEFAULT_CODEPAGE CP_ACP

-

-typedef HDC Context;

-

-typedef unsigned int uint32; /* int is 32-bits on Win32 and Win64. */

-#define PUTTY_UINT32_DEFINED

-

-#ifndef NO_GSSAPI

-/*

- * GSS-API stuff

- */

-#define GSS_CC CALLBACK

-/*

-typedef struct Ssh_gss_buf {

-    size_t length;

-    char *value;

-} Ssh_gss_buf;

-

-#define SSH_GSS_EMPTY_BUF (Ssh_gss_buf) {0,NULL}

-typedef void *Ssh_gss_name;

-*/

-#endif

-

-/*

- * Window handles for the windows that can be running during a

- * PuTTY session.

- */

-GLOBAL HWND hwnd;	/* the main terminal window */

-GLOBAL HWND logbox;

-

-/*

- * The all-important instance handle.

- */

-GLOBAL HINSTANCE hinst;

-

-/*

- * Help file stuff in winhelp.c.

- */

-void init_help(void);

-void shutdown_help(void);

-int has_help(void);

-void launch_help(HWND hwnd, const char *topic);

-void quit_help(HWND hwnd);

-

-/*

- * The terminal and logging context are notionally local to the

- * Windows front end, but they must be shared between window.c and

- * windlg.c. Likewise the saved-sessions list.

- */

-GLOBAL Terminal *term;

-GLOBAL void *logctx;

-

-#define WM_NETEVENT  (WM_APP + 5)

-

-/*

- * On Windows, we send MA_2CLK as the only event marking the second

- * press of a mouse button. Compare unix.h.

- */

-#define MULTICLICK_ONLY_EVENT 1

-

-/*

- * On Windows, data written to the clipboard must be NUL-terminated.

- */

-#define SELECTION_NUL_TERMINATED 1

-

-/*

- * On Windows, copying to the clipboard terminates lines with CRLF.

- */

-#define SEL_NL { 13, 10 }

-

-/*

- * sk_getxdmdata() does not exist under Windows (not that I

- * couldn't write it if I wanted to, but I haven't bothered), so

- * it's a macro which always returns NULL. With any luck this will

- * cause the compiler to notice it can optimise away the

- * implementation of XDM-AUTHORIZATION-1 in x11fwd.c :-)

- */

-#define sk_getxdmdata(socket, lenp) (NULL)

-

-/*

- * File-selector filter strings used in the config box. On Windows,

- * these strings are of exactly the type needed to go in

- * `lpstrFilter' in an OPENFILENAME structure.

- */

-#define FILTER_KEY_FILES ("PuTTY Private Key Files (*.ppk)\0*.ppk\0" \

-			      "All Files (*.*)\0*\0\0\0")

-#define FILTER_WAVE_FILES ("Wave Files (*.wav)\0*.WAV\0" \

-			       "All Files (*.*)\0*\0\0\0")

-#define FILTER_DYNLIB_FILES ("Dynamic Library Files (*.dll)\0*.dll\0" \

-				 "All Files (*.*)\0*\0\0\0")

-

-/*

- * On some versions of Windows, it has been known for WM_TIMER to

- * occasionally get its callback time simply wrong, and call us

- * back several minutes early. Defining these symbols enables

- * compensation code in timing.c.

- */

-#define TIMING_SYNC

-#define TIMING_SYNC_TICKCOUNT

-

-/*

- * winnet.c dynamically loads WinSock 2 or WinSock 1 depending on

- * what it can get, which means any WinSock routines used outside

- * that module must be exported from it as function pointers. So

- * here they are.

- */

-DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAAsyncSelect,

-		      (SOCKET, HWND, u_int, long));

-DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAEventSelect,

-		      (SOCKET, WSAEVENT, long));

-DECL_WINDOWS_FUNCTION(GLOBAL, int, select,

-		      (int, fd_set FAR *, fd_set FAR *,

-		       fd_set FAR *, const struct timeval FAR *));

-DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAGetLastError, (void));

-DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAEnumNetworkEvents,

-		      (SOCKET, WSAEVENT, LPWSANETWORKEVENTS));

-

-extern int socket_writable(SOCKET skt);

-

-extern void socket_reselect_all(void);

-

-/*

- * Exports from winctrls.c.

- */

-

-struct ctlpos {

-    HWND hwnd;

-    WPARAM font;

-    int dlu4inpix;

-    int ypos, width;

-    int xoff;

-    int boxystart, boxid;

-    char *boxtext;

-};

-

-/*

- * Exports from winutils.c.

- */

-typedef struct filereq_tag filereq; /* cwd for file requester */

-BOOL request_file(filereq *state, OPENFILENAME *of, int preserve, int save);

-filereq *filereq_new(void);

-void filereq_free(filereq *state);

-int message_box(LPCTSTR text, LPCTSTR caption, DWORD style, DWORD helpctxid);

-char *GetDlgItemText_alloc(HWND hwnd, int id);

-void split_into_argv(char *, int *, char ***, char ***);

-

-/*

- * Private structure for prefslist state. Only in the header file

- * so that we can delegate allocation to callers.

- */

-struct prefslist {

-    int listid, upbid, dnbid;

-    int srcitem;

-    int dummyitem;

-    int dragging;

-};

-

-/*

- * This structure is passed to event handler functions as the `dlg'

- * parameter, and hence is passed back to winctrls access functions.

- */

-struct dlgparam {

-    HWND hwnd;			       /* the hwnd of the dialog box */

-    struct winctrls *controltrees[8];  /* can have several of these */

-    int nctrltrees;

-    char *wintitle;		       /* title of actual window */

-    char *errtitle;		       /* title of error sub-messageboxes */

-    void *data;			       /* data to pass in refresh events */

-    union control *focused, *lastfocused; /* which ctrl has focus now/before */

-    char shortcuts[128];	       /* track which shortcuts in use */

-    int coloursel_wanted;	       /* has an event handler asked for

-					* a colour selector? */

-    struct { unsigned char r, g, b, ok; } coloursel_result;   /* 0-255 */

-    tree234 *privdata;		       /* stores per-control private data */

-    int ended, endresult;	       /* has the dialog been ended? */

-    int fixed_pitch_fonts;             /* are we constrained to fixed fonts? */

-};

-

-/*

- * Exports from winctrls.c.

- */

-void ctlposinit(struct ctlpos *cp, HWND hwnd,

-		int leftborder, int rightborder, int topborder);

-HWND doctl(struct ctlpos *cp, RECT r,

-	   char *wclass, int wstyle, int exstyle, char *wtext, int wid);

-void bartitle(struct ctlpos *cp, char *name, int id);

-void beginbox(struct ctlpos *cp, char *name, int idbox);

-void endbox(struct ctlpos *cp);

-void editboxfw(struct ctlpos *cp, int password, char *text,

-	       int staticid, int editid);

-void radioline(struct ctlpos *cp, char *text, int id, int nacross, ...);

-void bareradioline(struct ctlpos *cp, int nacross, ...);

-void radiobig(struct ctlpos *cp, char *text, int id, ...);

-void checkbox(struct ctlpos *cp, char *text, int id);

-void statictext(struct ctlpos *cp, char *text, int lines, int id);

-void staticbtn(struct ctlpos *cp, char *stext, int sid,

-	       char *btext, int bid);

-void static2btn(struct ctlpos *cp, char *stext, int sid,

-		char *btext1, int bid1, char *btext2, int bid2);

-void staticedit(struct ctlpos *cp, char *stext,

-		int sid, int eid, int percentedit);

-void staticddl(struct ctlpos *cp, char *stext,

-	       int sid, int lid, int percentlist);

-void combobox(struct ctlpos *cp, char *text, int staticid, int listid);

-void staticpassedit(struct ctlpos *cp, char *stext,

-		    int sid, int eid, int percentedit);

-void bigeditctrl(struct ctlpos *cp, char *stext,

-		 int sid, int eid, int lines);

-void ersatztab(struct ctlpos *cp, char *stext, int sid, int lid, int s2id);

-void editbutton(struct ctlpos *cp, char *stext, int sid,

-		int eid, char *btext, int bid);

-void sesssaver(struct ctlpos *cp, char *text,

-	       int staticid, int editid, int listid, ...);

-void envsetter(struct ctlpos *cp, char *stext, int sid,

-	       char *e1stext, int e1sid, int e1id,

-	       char *e2stext, int e2sid, int e2id,

-	       int listid, char *b1text, int b1id, char *b2text, int b2id);

-void charclass(struct ctlpos *cp, char *stext, int sid, int listid,

-	       char *btext, int bid, int eid, char *s2text, int s2id);

-void colouredit(struct ctlpos *cp, char *stext, int sid, int listid,

-		char *btext, int bid, ...);

-void prefslist(struct prefslist *hdl, struct ctlpos *cp, int lines,

-	       char *stext, int sid, int listid, int upbid, int dnbid);

-int handle_prefslist(struct prefslist *hdl,

-		     int *array, int maxmemb,

-		     int is_dlmsg, HWND hwnd,

-		     WPARAM wParam, LPARAM lParam);

-void progressbar(struct ctlpos *cp, int id);

-void fwdsetter(struct ctlpos *cp, int listid, char *stext, int sid,

-	       char *e1stext, int e1sid, int e1id,

-	       char *e2stext, int e2sid, int e2id,

-	       char *btext, int bid,

-	       char *r1text, int r1id, char *r2text, int r2id);

-

-void dlg_auto_set_fixed_pitch_flag(void *dlg);

-int dlg_get_fixed_pitch_flag(void *dlg);

-void dlg_set_fixed_pitch_flag(void *dlg, int flag);

-

-#define MAX_SHORTCUTS_PER_CTRL 16

-

-/*

- * This structure is what's stored for each `union control' in the

- * portable-dialog interface.

- */

-struct winctrl {

-    union control *ctrl;

-    /*

-     * The control may have several components at the Windows

-     * level, with different dialog IDs. To avoid needing N

-     * separate platformsidectrl structures (which could be stored

-     * separately in a tree234 so that lookup by ID worked), we

-     * impose the constraint that those IDs must be in a contiguous

-     * block.

-     */

-    int base_id;

-    int num_ids;

-    /*

-     * Remember what keyboard shortcuts were used by this control,

-     * so that when we remove it again we can take them out of the

-     * list in the dlgparam.

-     */

-    char shortcuts[MAX_SHORTCUTS_PER_CTRL];

-    /*

-     * Some controls need a piece of allocated memory in which to

-     * store temporary data about the control.

-     */

-    void *data;

-};

-/*

- * And this structure holds a set of the above, in two separate

- * tree234s so that it can find an item by `union control' or by

- * dialog ID.

- */

-struct winctrls {

-    tree234 *byctrl, *byid;

-};

-struct controlset;

-struct controlbox;

-

-void winctrl_init(struct winctrls *);

-void winctrl_cleanup(struct winctrls *);

-void winctrl_add(struct winctrls *, struct winctrl *);

-void winctrl_remove(struct winctrls *, struct winctrl *);

-struct winctrl *winctrl_findbyctrl(struct winctrls *, union control *);

-struct winctrl *winctrl_findbyid(struct winctrls *, int);

-struct winctrl *winctrl_findbyindex(struct winctrls *, int);

-void winctrl_layout(struct dlgparam *dp, struct winctrls *wc,

-		    struct ctlpos *cp, struct controlset *s, int *id);

-int winctrl_handle_command(struct dlgparam *dp, UINT msg,

-			   WPARAM wParam, LPARAM lParam);

-void winctrl_rem_shortcuts(struct dlgparam *dp, struct winctrl *c);

-int winctrl_context_help(struct dlgparam *dp, HWND hwnd, int id);

-

-void dp_init(struct dlgparam *dp);

-void dp_add_tree(struct dlgparam *dp, struct winctrls *tree);

-void dp_cleanup(struct dlgparam *dp);

-

-/*

- * Exports from wincfg.c.

- */

-void win_setup_config_box(struct controlbox *b, HWND *hwndp, int has_help,

-			  int midsession, int protocol);

-

-/*

- * Exports from windlg.c.

- */

-void defuse_showwindow(void);

-int do_config(void);

-int do_reconfig(HWND, int);

-void showeventlog(HWND);

-void showabout(HWND);

-void force_normal(HWND hwnd);

-void modal_about_box(HWND hwnd);

-void show_help(HWND hwnd);

-

-/*

- * Exports from winmisc.c.

- */

-extern OSVERSIONINFO osVersion;

-BOOL init_winver(void);

-HMODULE load_system32_dll(const char *libname);

-

-/*

- * Exports from sizetip.c.

- */

-void UpdateSizeTip(HWND src, int cx, int cy);

-void EnableSizeTip(int bEnable);

-

-/*

- * Exports from unicode.c.

- */

-struct unicode_data;

-void init_ucs(Conf *, struct unicode_data *);

-

-/*

- * Exports from winhandl.c.

- */

-#define HANDLE_FLAG_OVERLAPPED 1

-#define HANDLE_FLAG_IGNOREEOF 2

-#define HANDLE_FLAG_UNITBUFFER 4

-struct handle;

-typedef int (*handle_inputfn_t)(struct handle *h, void *data, int len);

-typedef void (*handle_outputfn_t)(struct handle *h, int new_backlog);

-struct handle *handle_input_new(HANDLE handle, handle_inputfn_t gotdata,

-				void *privdata, int flags);

-struct handle *handle_output_new(HANDLE handle, handle_outputfn_t sentdata,

-				 void *privdata, int flags);

-int handle_write(struct handle *h, const void *data, int len);

-void handle_write_eof(struct handle *h);

-HANDLE *handle_get_events(int *nevents);

-void handle_free(struct handle *h);

-void handle_got_event(HANDLE event);

-void handle_unthrottle(struct handle *h, int backlog);

-int handle_backlog(struct handle *h);

-void *handle_get_privdata(struct handle *h);

-

-/*

- * winpgntc.c needs to schedule callbacks for asynchronous agent

- * requests. This has to be done differently in GUI and console, so

- * there's an exported function used for the purpose.

- * 

- * Also, we supply FLAG_SYNCAGENT to force agent requests to be

- * synchronous in pscp and psftp.

- */

-void agent_schedule_callback(void (*callback)(void *, void *, int),

-			     void *callback_ctx, void *data, int len);

-#define FLAG_SYNCAGENT 0x1000

-

-/*

- * winpgntc.c also exports these two functions which are used by the

- * server side of Pageant as well, to get the user SID for comparing

- * with clients'.

- */

-int init_advapi(void);  /* initialises everything needed by get_user_sid */

-PSID get_user_sid(void);

-

-/*

- * Exports from winser.c.

- */

-extern Backend serial_backend;

-

-/*

- * Exports from winjump.c.

- */

-#define JUMPLIST_SUPPORTED             /* suppress #defines in putty.h */

-void add_session_to_jumplist(const char * const sessionname);

-void remove_session_from_jumplist(const char * const sessionname);

-void clear_jumplist(void);

-

-/*

- * Extra functions in winstore.c over and above the interface in

- * storage.h.

- *

- * These functions manipulate the Registry section which mirrors the

- * current Windows 7 jump list. (Because the real jump list storage is

- * write-only, we need to keep another copy of whatever we put in it,

- * so that we can put in a slightly modified version the next time.)

- */

-

-/* Adds a saved session to the registry jump list mirror. 'item' is a

- * string naming a saved session. */

-int add_to_jumplist_registry(const char *item);

-

-/* Removes an item from the registry jump list mirror. */

-int remove_from_jumplist_registry(const char *item);

-

-/* Returns the current jump list entries from the registry. Caller

- * must free the returned pointer, which points to a contiguous

- * sequence of NUL-terminated strings in memory, terminated with an

- * empty one. */

-char *get_jumplist_registry_entries(void);

-

-#endif

+/*
+ * winstuff.h: Windows-specific inter-module stuff.
+ */
+
+#ifndef PUTTY_WINSTUFF_H
+#define PUTTY_WINSTUFF_H
+
+#ifndef AUTO_WINSOCK
+#include <winsock2.h>
+#endif
+#include <windows.h>
+#include <stdio.h>		       /* for FILENAME_MAX */
+
+#include "tree234.h"
+
+#include "winhelp.h"
+
+struct Filename {
+    char *path;
+};
+#define f_open(filename, mode, isprivate) ( fopen((filename)->path, (mode)) )
+
+struct FontSpec {
+    char *name;
+    int isbold;
+    int height;
+    int charset;
+};
+struct FontSpec *fontspec_new(const char *name,
+                               int bold, int height, int charset);
+
+#ifndef CLEARTYPE_QUALITY
+#define CLEARTYPE_QUALITY 5
+#endif
+#define FONT_QUALITY(fq) ( \
+    (fq) == FQ_DEFAULT ? DEFAULT_QUALITY : \
+    (fq) == FQ_ANTIALIASED ? ANTIALIASED_QUALITY : \
+    (fq) == FQ_NONANTIALIASED ? NONANTIALIASED_QUALITY : \
+    CLEARTYPE_QUALITY)
+
+#define PLATFORM_IS_UTF16 /* enable UTF-16 processing when exchanging
+			   * wchar_t strings with environment */
+
+/*
+ * Where we can, we use GetWindowLongPtr and friends because they're
+ * more useful on 64-bit platforms, but they're a relatively recent
+ * innovation, missing from VC++ 6 and older MinGW.  Degrade nicely.
+ * (NB that on some systems, some of these things are available but
+ * not others...)
+ */
+
+#ifndef GCLP_HCURSOR
+/* GetClassLongPtr and friends */
+#undef  GetClassLongPtr
+#define GetClassLongPtr GetClassLong
+#undef  SetClassLongPtr
+#define SetClassLongPtr SetClassLong
+#define GCLP_HCURSOR GCL_HCURSOR
+/* GetWindowLongPtr and friends */
+#undef  GetWindowLongPtr
+#define GetWindowLongPtr GetWindowLong
+#undef  SetWindowLongPtr
+#define SetWindowLongPtr SetWindowLong
+#undef  GWLP_USERDATA
+#define GWLP_USERDATA GWL_USERDATA
+#undef  DWLP_MSGRESULT
+#define DWLP_MSGRESULT DWL_MSGRESULT
+/* Since we've clobbered the above functions, we should clobber the
+ * associated type regardless of whether it's defined. */
+#undef LONG_PTR
+#define LONG_PTR LONG
+#endif
+
+#define BOXFLAGS DLGWINDOWEXTRA
+#define BOXRESULT (DLGWINDOWEXTRA + sizeof(LONG_PTR))
+#define DF_END 0x0001
+
+#ifndef NO_SECUREZEROMEMORY
+#define PLATFORM_HAS_SMEMCLR /* inhibit cross-platform one in misc.c */
+#endif
+
+/*
+ * Dynamically linked functions. These come in two flavours:
+ *
+ *  - GET_WINDOWS_FUNCTION does not expose "name" to the preprocessor,
+ *    so will always dynamically link against exactly what is specified
+ *    in "name". If you're not sure, use this one.
+ *
+ *  - GET_WINDOWS_FUNCTION_PP allows "name" to be redirected via
+ *    preprocessor definitions like "#define foo bar"; this is principally
+ *    intended for the ANSI/Unicode DoSomething/DoSomethingA/DoSomethingW.
+ *    If your function has an argument of type "LPTSTR" or similar, this
+ *    is the variant to use.
+ *    (However, it can't always be used, as it trips over more complicated
+ *    macro trickery such as the WspiapiGetAddrInfo wrapper for getaddrinfo.)
+ *
+ * (DECL_WINDOWS_FUNCTION works with both these variants.)
+ */
+#define DECL_WINDOWS_FUNCTION(linkage, rettype, name, params) \
+    typedef rettype (WINAPI *t_##name) params; \
+    linkage t_##name p_##name
+#define STR1(x) #x
+#define STR(x) STR1(x)
+#define GET_WINDOWS_FUNCTION_PP(module, name) \
+    (p_##name = module ? (t_##name) GetProcAddress(module, STR(name)) : NULL)
+#define GET_WINDOWS_FUNCTION(module, name) \
+    (p_##name = module ? (t_##name) GetProcAddress(module, #name) : NULL)
+
+/*
+ * Global variables. Most modules declare these `extern', but
+ * window.c will do `#define PUTTY_DO_GLOBALS' before including this
+ * module, and so will get them properly defined.
+*/
+#ifndef GLOBAL
+#ifdef PUTTY_DO_GLOBALS
+#define GLOBAL
+#else
+#define GLOBAL extern
+#endif
+#endif
+
+#ifndef DONE_TYPEDEFS
+#define DONE_TYPEDEFS
+typedef struct conf_tag Conf;
+typedef struct backend_tag Backend;
+typedef struct terminal_tag Terminal;
+#endif
+
+#define PUTTY_REG_POS "Software\\SimonTatham\\PuTTY"
+#define PUTTY_REG_PARENT "Software\\SimonTatham"
+#define PUTTY_REG_PARENT_CHILD "PuTTY"
+#define PUTTY_REG_GPARENT "Software"
+#define PUTTY_REG_GPARENT_CHILD "SimonTatham"
+
+/* Result values for the jumplist registry functions. */
+#define JUMPLISTREG_OK 0
+#define JUMPLISTREG_ERROR_INVALID_PARAMETER 1
+#define JUMPLISTREG_ERROR_KEYOPENCREATE_FAILURE 2
+#define JUMPLISTREG_ERROR_VALUEREAD_FAILURE 3
+#define JUMPLISTREG_ERROR_VALUEWRITE_FAILURE 4
+#define JUMPLISTREG_ERROR_INVALID_VALUE 5
+
+#define PUTTY_HELP_FILE "putty.hlp"
+#define PUTTY_CHM_FILE "putty.chm"
+#define PUTTY_HELP_CONTENTS "putty.cnt"
+
+#define GETTICKCOUNT GetTickCount
+#define CURSORBLINK GetCaretBlinkTime()
+#define TICKSPERSEC 1000	       /* GetTickCount returns milliseconds */
+
+#define DEFAULT_CODEPAGE CP_ACP
+#define USES_VTLINE_HACK
+
+typedef HDC Context;
+
+typedef unsigned int uint32; /* int is 32-bits on Win32 and Win64. */
+#define PUTTY_UINT32_DEFINED
+
+#ifndef NO_GSSAPI
+/*
+ * GSS-API stuff
+ */
+#define GSS_CC CALLBACK
+/*
+typedef struct Ssh_gss_buf {
+    size_t length;
+    char *value;
+} Ssh_gss_buf;
+
+#define SSH_GSS_EMPTY_BUF (Ssh_gss_buf) {0,NULL}
+typedef void *Ssh_gss_name;
+*/
+#endif
+
+/*
+ * Window handles for the windows that can be running during a
+ * PuTTY session.
+ */
+GLOBAL HWND hwnd;	/* the main terminal window */
+GLOBAL HWND logbox;
+
+/*
+ * The all-important instance handle.
+ */
+GLOBAL HINSTANCE hinst;
+
+/*
+ * Help file stuff in winhelp.c.
+ */
+void init_help(void);
+void shutdown_help(void);
+int has_help(void);
+void launch_help(HWND hwnd, const char *topic);
+void quit_help(HWND hwnd);
+
+/*
+ * The terminal and logging context are notionally local to the
+ * Windows front end, but they must be shared between window.c and
+ * windlg.c. Likewise the saved-sessions list.
+ */
+GLOBAL Terminal *term;
+GLOBAL void *logctx;
+
+#define WM_NETEVENT  (WM_APP + 5)
+
+/*
+ * On Windows, we send MA_2CLK as the only event marking the second
+ * press of a mouse button. Compare unix.h.
+ */
+#define MULTICLICK_ONLY_EVENT 1
+
+/*
+ * On Windows, data written to the clipboard must be NUL-terminated.
+ */
+#define SELECTION_NUL_TERMINATED 1
+
+/*
+ * On Windows, copying to the clipboard terminates lines with CRLF.
+ */
+#define SEL_NL { 13, 10 }
+
+/*
+ * sk_getxdmdata() does not exist under Windows (not that I
+ * couldn't write it if I wanted to, but I haven't bothered), so
+ * it's a macro which always returns NULL. With any luck this will
+ * cause the compiler to notice it can optimise away the
+ * implementation of XDM-AUTHORIZATION-1 in x11fwd.c :-)
+ */
+#define sk_getxdmdata(socket, lenp) (NULL)
+
+/*
+ * File-selector filter strings used in the config box. On Windows,
+ * these strings are of exactly the type needed to go in
+ * `lpstrFilter' in an OPENFILENAME structure.
+ */
+#define FILTER_KEY_FILES ("PuTTY Private Key Files (*.ppk)\0*.ppk\0" \
+			      "All Files (*.*)\0*\0\0\0")
+#define FILTER_WAVE_FILES ("Wave Files (*.wav)\0*.WAV\0" \
+			       "All Files (*.*)\0*\0\0\0")
+#define FILTER_DYNLIB_FILES ("Dynamic Library Files (*.dll)\0*.dll\0" \
+				 "All Files (*.*)\0*\0\0\0")
+
+/*
+ * Exports from winnet.c.
+ */
+extern int select_result(WPARAM, LPARAM);
+
+/*
+ * winnet.c dynamically loads WinSock 2 or WinSock 1 depending on
+ * what it can get, which means any WinSock routines used outside
+ * that module must be exported from it as function pointers. So
+ * here they are.
+ */
+DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAAsyncSelect,
+		      (SOCKET, HWND, u_int, long));
+DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAEventSelect,
+		      (SOCKET, WSAEVENT, long));
+DECL_WINDOWS_FUNCTION(GLOBAL, int, select,
+		      (int, fd_set FAR *, fd_set FAR *,
+		       fd_set FAR *, const struct timeval FAR *));
+DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAGetLastError, (void));
+DECL_WINDOWS_FUNCTION(GLOBAL, int, WSAEnumNetworkEvents,
+		      (SOCKET, WSAEVENT, LPWSANETWORKEVENTS));
+
+extern int socket_writable(SOCKET skt);
+
+extern void socket_reselect_all(void);
+
+/*
+ * Exports from winctrls.c.
+ */
+
+struct ctlpos {
+    HWND hwnd;
+    WPARAM font;
+    int dlu4inpix;
+    int ypos, width;
+    int xoff;
+    int boxystart, boxid;
+    char *boxtext;
+};
+
+/*
+ * Exports from winutils.c.
+ */
+typedef struct filereq_tag filereq; /* cwd for file requester */
+BOOL request_file(filereq *state, OPENFILENAME *of, int preserve, int save);
+filereq *filereq_new(void);
+void filereq_free(filereq *state);
+int message_box(LPCTSTR text, LPCTSTR caption, DWORD style, DWORD helpctxid);
+char *GetDlgItemText_alloc(HWND hwnd, int id);
+void split_into_argv(char *, int *, char ***, char ***);
+
+/*
+ * Private structure for prefslist state. Only in the header file
+ * so that we can delegate allocation to callers.
+ */
+struct prefslist {
+    int listid, upbid, dnbid;
+    int srcitem;
+    int dummyitem;
+    int dragging;
+};
+
+/*
+ * This structure is passed to event handler functions as the `dlg'
+ * parameter, and hence is passed back to winctrls access functions.
+ */
+struct dlgparam {
+    HWND hwnd;			       /* the hwnd of the dialog box */
+    struct winctrls *controltrees[8];  /* can have several of these */
+    int nctrltrees;
+    char *wintitle;		       /* title of actual window */
+    char *errtitle;		       /* title of error sub-messageboxes */
+    void *data;			       /* data to pass in refresh events */
+    union control *focused, *lastfocused; /* which ctrl has focus now/before */
+    char shortcuts[128];	       /* track which shortcuts in use */
+    int coloursel_wanted;	       /* has an event handler asked for
+					* a colour selector? */
+    struct { unsigned char r, g, b, ok; } coloursel_result;   /* 0-255 */
+    tree234 *privdata;		       /* stores per-control private data */
+    int ended, endresult;	       /* has the dialog been ended? */
+    int fixed_pitch_fonts;             /* are we constrained to fixed fonts? */
+};
+
+/*
+ * Exports from winctrls.c.
+ */
+void ctlposinit(struct ctlpos *cp, HWND hwnd,
+		int leftborder, int rightborder, int topborder);
+HWND doctl(struct ctlpos *cp, RECT r,
+	   char *wclass, int wstyle, int exstyle, char *wtext, int wid);
+void bartitle(struct ctlpos *cp, char *name, int id);
+void beginbox(struct ctlpos *cp, char *name, int idbox);
+void endbox(struct ctlpos *cp);
+void editboxfw(struct ctlpos *cp, int password, char *text,
+	       int staticid, int editid);
+void radioline(struct ctlpos *cp, char *text, int id, int nacross, ...);
+void bareradioline(struct ctlpos *cp, int nacross, ...);
+void radiobig(struct ctlpos *cp, char *text, int id, ...);
+void checkbox(struct ctlpos *cp, char *text, int id);
+void statictext(struct ctlpos *cp, char *text, int lines, int id);
+void staticbtn(struct ctlpos *cp, char *stext, int sid,
+	       char *btext, int bid);
+void static2btn(struct ctlpos *cp, char *stext, int sid,
+		char *btext1, int bid1, char *btext2, int bid2);
+void staticedit(struct ctlpos *cp, char *stext,
+		int sid, int eid, int percentedit);
+void staticddl(struct ctlpos *cp, char *stext,
+	       int sid, int lid, int percentlist);
+void combobox(struct ctlpos *cp, char *text, int staticid, int listid);
+void staticpassedit(struct ctlpos *cp, char *stext,
+		    int sid, int eid, int percentedit);
+void bigeditctrl(struct ctlpos *cp, char *stext,
+		 int sid, int eid, int lines);
+void ersatztab(struct ctlpos *cp, char *stext, int sid, int lid, int s2id);
+void editbutton(struct ctlpos *cp, char *stext, int sid,
+		int eid, char *btext, int bid);
+void sesssaver(struct ctlpos *cp, char *text,
+	       int staticid, int editid, int listid, ...);
+void envsetter(struct ctlpos *cp, char *stext, int sid,
+	       char *e1stext, int e1sid, int e1id,
+	       char *e2stext, int e2sid, int e2id,
+	       int listid, char *b1text, int b1id, char *b2text, int b2id);
+void charclass(struct ctlpos *cp, char *stext, int sid, int listid,
+	       char *btext, int bid, int eid, char *s2text, int s2id);
+void colouredit(struct ctlpos *cp, char *stext, int sid, int listid,
+		char *btext, int bid, ...);
+void prefslist(struct prefslist *hdl, struct ctlpos *cp, int lines,
+	       char *stext, int sid, int listid, int upbid, int dnbid);
+int handle_prefslist(struct prefslist *hdl,
+		     int *array, int maxmemb,
+		     int is_dlmsg, HWND hwnd,
+		     WPARAM wParam, LPARAM lParam);
+void progressbar(struct ctlpos *cp, int id);
+void fwdsetter(struct ctlpos *cp, int listid, char *stext, int sid,
+	       char *e1stext, int e1sid, int e1id,
+	       char *e2stext, int e2sid, int e2id,
+	       char *btext, int bid,
+	       char *r1text, int r1id, char *r2text, int r2id);
+
+void dlg_auto_set_fixed_pitch_flag(void *dlg);
+int dlg_get_fixed_pitch_flag(void *dlg);
+void dlg_set_fixed_pitch_flag(void *dlg, int flag);
+
+#define MAX_SHORTCUTS_PER_CTRL 16
+
+/*
+ * This structure is what's stored for each `union control' in the
+ * portable-dialog interface.
+ */
+struct winctrl {
+    union control *ctrl;
+    /*
+     * The control may have several components at the Windows
+     * level, with different dialog IDs. To avoid needing N
+     * separate platformsidectrl structures (which could be stored
+     * separately in a tree234 so that lookup by ID worked), we
+     * impose the constraint that those IDs must be in a contiguous
+     * block.
+     */
+    int base_id;
+    int num_ids;
+    /*
+     * Remember what keyboard shortcuts were used by this control,
+     * so that when we remove it again we can take them out of the
+     * list in the dlgparam.
+     */
+    char shortcuts[MAX_SHORTCUTS_PER_CTRL];
+    /*
+     * Some controls need a piece of allocated memory in which to
+     * store temporary data about the control.
+     */
+    void *data;
+};
+/*
+ * And this structure holds a set of the above, in two separate
+ * tree234s so that it can find an item by `union control' or by
+ * dialog ID.
+ */
+struct winctrls {
+    tree234 *byctrl, *byid;
+};
+struct controlset;
+struct controlbox;
+
+void winctrl_init(struct winctrls *);
+void winctrl_cleanup(struct winctrls *);
+void winctrl_add(struct winctrls *, struct winctrl *);
+void winctrl_remove(struct winctrls *, struct winctrl *);
+struct winctrl *winctrl_findbyctrl(struct winctrls *, union control *);
+struct winctrl *winctrl_findbyid(struct winctrls *, int);
+struct winctrl *winctrl_findbyindex(struct winctrls *, int);
+void winctrl_layout(struct dlgparam *dp, struct winctrls *wc,
+		    struct ctlpos *cp, struct controlset *s, int *id);
+int winctrl_handle_command(struct dlgparam *dp, UINT msg,
+			   WPARAM wParam, LPARAM lParam);
+void winctrl_rem_shortcuts(struct dlgparam *dp, struct winctrl *c);
+int winctrl_context_help(struct dlgparam *dp, HWND hwnd, int id);
+
+void dp_init(struct dlgparam *dp);
+void dp_add_tree(struct dlgparam *dp, struct winctrls *tree);
+void dp_cleanup(struct dlgparam *dp);
+
+/*
+ * Exports from wincfg.c.
+ */
+void win_setup_config_box(struct controlbox *b, HWND *hwndp, int has_help,
+			  int midsession, int protocol);
+
+/*
+ * Exports from windlg.c.
+ */
+void defuse_showwindow(void);
+int do_config(void);
+int do_reconfig(HWND, int);
+void showeventlog(HWND);
+void showabout(HWND);
+void force_normal(HWND hwnd);
+void modal_about_box(HWND hwnd);
+void show_help(HWND hwnd);
+
+/*
+ * Exports from winmisc.c.
+ */
+extern OSVERSIONINFO osVersion;
+BOOL init_winver(void);
+HMODULE load_system32_dll(const char *libname);
+const char *win_strerror(int error);
+
+/*
+ * Exports from sizetip.c.
+ */
+void UpdateSizeTip(HWND src, int cx, int cy);
+void EnableSizeTip(int bEnable);
+
+/*
+ * Exports from unicode.c.
+ */
+struct unicode_data;
+void init_ucs(Conf *, struct unicode_data *);
+
+/*
+ * Exports from winhandl.c.
+ */
+#define HANDLE_FLAG_OVERLAPPED 1
+#define HANDLE_FLAG_IGNOREEOF 2
+#define HANDLE_FLAG_UNITBUFFER 4
+struct handle;
+typedef int (*handle_inputfn_t)(struct handle *h, void *data, int len);
+typedef void (*handle_outputfn_t)(struct handle *h, int new_backlog);
+struct handle *handle_input_new(HANDLE handle, handle_inputfn_t gotdata,
+				void *privdata, int flags);
+struct handle *handle_output_new(HANDLE handle, handle_outputfn_t sentdata,
+				 void *privdata, int flags);
+int handle_write(struct handle *h, const void *data, int len);
+void handle_write_eof(struct handle *h);
+HANDLE *handle_get_events(int *nevents);
+void handle_free(struct handle *h);
+void handle_got_event(HANDLE event);
+void handle_unthrottle(struct handle *h, int backlog);
+int handle_backlog(struct handle *h);
+void *handle_get_privdata(struct handle *h);
+struct handle *handle_add_foreign_event(HANDLE event,
+                                        void (*callback)(void *), void *ctx);
+
+/*
+ * winpgntc.c needs to schedule callbacks for asynchronous agent
+ * requests. This has to be done differently in GUI and console, so
+ * there's an exported function used for the purpose.
+ * 
+ * Also, we supply FLAG_SYNCAGENT to force agent requests to be
+ * synchronous in pscp and psftp.
+ */
+void agent_schedule_callback(void (*callback)(void *, void *, int),
+			     void *callback_ctx, void *data, int len);
+#define FLAG_SYNCAGENT 0x1000
+
+/*
+ * Exports from winser.c.
+ */
+extern Backend serial_backend;
+
+/*
+ * Exports from winjump.c.
+ */
+#define JUMPLIST_SUPPORTED             /* suppress #defines in putty.h */
+void add_session_to_jumplist(const char * const sessionname);
+void remove_session_from_jumplist(const char * const sessionname);
+void clear_jumplist(void);
+
+/*
+ * Extra functions in winstore.c over and above the interface in
+ * storage.h.
+ *
+ * These functions manipulate the Registry section which mirrors the
+ * current Windows 7 jump list. (Because the real jump list storage is
+ * write-only, we need to keep another copy of whatever we put in it,
+ * so that we can put in a slightly modified version the next time.)
+ */
+
+/* Adds a saved session to the registry jump list mirror. 'item' is a
+ * string naming a saved session. */
+int add_to_jumplist_registry(const char *item);
+
+/* Removes an item from the registry jump list mirror. */
+int remove_from_jumplist_registry(const char *item);
+
+/* Returns the current jump list entries from the registry. Caller
+ * must free the returned pointer, which points to a contiguous
+ * sequence of NUL-terminated strings in memory, terminated with an
+ * empty one. */
+char *get_jumplist_registry_entries(void);
+
+#endif