sdk/include/reactos/undocshell.h

   1 /*
   2  * Copyright 1999, 2000 Juergen Schmied
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #ifndef __WINE_UNDOCSHELL_H
  20 #define __WINE_UNDOCSHELL_H
  21
  22 #ifdef __cplusplus
  23 extern "C" {
  24 #endif /* defined(__cplusplus) */
  25
  26
  27 #if (NTDDI_VERSION < NTDDI_LONGHORN)
  28 #define DBIMF_NOGRIPPER         0x0800
  29 #define DBIMF_ALWAYSGRIPPER     0x1000
  30 #define DBIMF_NOMARGINS         0x2000
  31 #endif  // NTDDI_LONGHORN
  32
  33 #if defined (_SHELLAPI_H) || defined (_INC_SHELLAPI)
  34
  35 /****************************************************************************
  36  * Taskbar interface WM_COPYDATA structures
  37  * See http://www.geoffchappell.com/studies/windows/shell/shell32/api/shlnot/copydata.htm
  38  */
  39 /* Data structure for Shell_NotifyIcon messages */
  40 typedef struct _TRAYNOTIFYDATAW
  41 {
  42     DWORD dwSignature;
  43     DWORD dwMessage;
  44     NOTIFYICONDATAW nid; // Always use the latest NOTIFYICONDATAW structure version.
  45 } TRAYNOTIFYDATAW, *PTRAYNOTIFYDATAW;
  46 // Note: One could also introduce TRAYNOTIFYDATAA
  47
  48 #define NI_NOTIFY_SIG 0x34753423 /* TRAYNOTIFYDATA */
  49
  50 #endif /* defined (_SHELLAPI_H) || defined (_INC_SHELLAPI) */
  51
  52
  53 /****************************************************************************
  54  * Taskbar WM_COMMAND identifiers
  55  */
  56 #define TWM_DOEXITWINDOWS (WM_USER + 342)
  57 #define TWM_CYCLEFOCUS (WM_USER + 348)
  58
  59
  60 /****************************************************************************
  61  *  IDList Functions
  62  */
  63 BOOL WINAPI ILGetDisplayName(
  64     LPCITEMIDLIST pidl,
  65     LPVOID path);
  66
  67 /* type parameter for ILGetDisplayNameEx() */
  68 #define ILGDN_FORPARSING  0
  69 #define ILGDN_NORMAL      1
  70 #define ILGDN_INFOLDER    2
  71
  72 BOOL WINAPI ILGetDisplayNameEx(
  73     LPSHELLFOLDER psf,
  74     LPCITEMIDLIST pidl,
  75     LPVOID path,
  76     DWORD type);
  77
  78 LPITEMIDLIST WINAPI ILGlobalClone(LPCITEMIDLIST pidl);
  79 void WINAPI ILGlobalFree(LPITEMIDLIST pidl);
  80 LPITEMIDLIST WINAPI SHSimpleIDListFromPathA (LPCSTR lpszPath); //FIXME
  81 LPITEMIDLIST WINAPI SHSimpleIDListFromPathW (LPCWSTR lpszPath);
  82
  83 HRESULT WINAPI SHILCreateFromPathA (
  84     LPCSTR path,
  85     LPITEMIDLIST * ppidl,
  86     DWORD *attributes);
  87
  88 HRESULT WINAPI SHILCreateFromPathW (
  89     LPCWSTR path,
  90     LPITEMIDLIST * ppidl,
  91     DWORD *attributes);
  92
  93 /*
  94     string functions
  95 */
  96 BOOL WINAPI StrRetToStrNA(LPSTR,DWORD,LPSTRRET,const ITEMIDLIST*);
  97 BOOL WINAPI StrRetToStrNW(LPWSTR,DWORD,LPSTRRET,const ITEMIDLIST*);
  98
  99
 100 /****************************************************************************
 101  * SHChangeNotifyRegister API
 102  */
 103 #define SHCNRF_InterruptLevel       0x0001
 104 #define SHCNRF_ShellLevel           0x0002
 105 #define SHCNRF_RecursiveInterrupt   0x1000  /* Must be combined with SHCNRF_InterruptLevel */
 106 #define SHCNRF_NewDelivery          0x8000  /* Messages use shared memory */
 107
 108
 109 /****************************************************************************
 110  * Shell Common Dialogs
 111  */
 112
 113 /* RunFileDlg flags */
 114 #define RFF_NOBROWSE        0x01    /* Removes the browse button */
 115 #define RFF_NODEFAULT       0x02    /* No default item selected */
 116 #define RFF_CALCDIRECTORY   0x04    /* Calculates the working directory from the file name */
 117 #define RFF_NOLABEL         0x08    /* Removes the edit box label */
 118 #define RFF_NOSEPARATEMEM   0x20    /* Removes the Separate Memory Space check box (Windows NT only) */
 119
 120 /* RunFileFlg notification value and structure */
 121 #define RFN_VALIDATE    (-510)
 122 #if 0 // Deprecated ANSI structure
 123 typedef struct _NMRUNFILEDLGA
 124 {
 125     NMHDR   hdr;
 126     LPCSTR  lpFile;
 127     LPCSTR  lpDirectory;
 128     UINT    nShow;
 129 } NMRUNFILEDLGA, *PNMRUNFILEDLGA, *LPNMRUNFILEDLGA;
 130 #endif
 131 typedef struct _NMRUNFILEDLGW
 132 {
 133     NMHDR   hdr;
 134     LPCWSTR lpFile;
 135     LPCWSTR lpDirectory;
 136     UINT    nShow;
 137 } NMRUNFILEDLGW, *PNMRUNFILEDLGW, *LPNMRUNFILEDLGW;
 138
 139 typedef NMRUNFILEDLGW NMRUNFILEDLG;
 140 typedef PNMRUNFILEDLGW PNMRUNFILEDLG;
 141 typedef LPNMRUNFILEDLGW LPNMRUNFILEDLG;
 142
 143 /* RunFileDlg notification return values */
 144 #define RF_OK      0x00
 145 #define RF_CANCEL  0x01
 146 #define RF_RETRY   0x02
 147
 148 void WINAPI RunFileDlg(
 149     HWND hWndOwner,
 150     HICON hIcon,
 151     LPCWSTR lpstrDirectory,
 152     LPCWSTR lpstrTitle,
 153     LPCWSTR lpstrDescription,
 154     UINT uFlags);
 155
 156 int WINAPI LogoffWindowsDialog(HWND hWndOwner);
 157 void WINAPI ExitWindowsDialog(HWND hWndOwner);
 158
 159 BOOL WINAPI SHFindComputer(
 160     LPCITEMIDLIST pidlRoot,
 161     LPCITEMIDLIST pidlSavedSearch);
 162
 163 void WINAPI SHHandleDiskFull(HWND hwndOwner,
 164     UINT uDrive);
 165
 166 int  WINAPI SHOutOfMemoryMessageBox(
 167     HWND hwndOwner,
 168     LPCSTR lpCaption,
 169     UINT uType);
 170
 171 DWORD WINAPI SHNetConnectionDialog(
 172     HWND hwndOwner,
 173     LPCWSTR lpstrRemoteName,
 174     DWORD dwType);
 175
 176 /****************************************************************************
 177  * Cabinet Window Messages
 178  */
 179
 180 #define CWM_SETPATH           (WM_USER + 2)
 181 #define CWM_WANTIDLE          (WM_USER + 3)
 182 #define CWM_GETSETCURRENTINFO (WM_USER + 4)
 183 #define CWM_SELECTITEM        (WM_USER + 5)
 184 #define CWM_SELECTITEMSTR     (WM_USER + 6)
 185 #define CWM_GETISHELLBROWSER  (WM_USER + 7)
 186 #define CWM_TESTPATH          (WM_USER + 9)
 187 #define CWM_STATECHANGE       (WM_USER + 10)
 188 #define CWM_GETPATH           (WM_USER + 12)
 189
 190 #define WM_GETISHELLBROWSER CWM_GETISHELLBROWSER
 191
 192 /* CWM_TESTPATH types */
 193 #define CWTP_ISEQUAL  0
 194 #define CWTP_ISCHILD  1
 195
 196 /* CWM_TESTPATH structure */
 197 typedef struct
 198 {
 199     DWORD dwType;
 200     ITEMIDLIST idl;
 201 } CWTESTPATHSTRUCT,* LPCWTESTPATHSTRUCT;
 202
 203 /****************************************************************************
 204  * System Imagelist Routines
 205  */
 206
 207 int WINAPI Shell_GetCachedImageIndexA(
 208     LPCSTR lpszFileName,
 209     int nIconIndex,
 210     UINT bSimulateDoc);
 211
 212 BOOL WINAPI Shell_GetImageLists(
 213     HIMAGELIST *lphimlLarge,
 214     HIMAGELIST *lphimlSmall);
 215
 216 HICON WINAPI SHGetFileIcon(
 217     DWORD dwReserved,
 218     LPCSTR lpszPath,
 219     DWORD dwFileAttributes,
 220     UINT uFlags);
 221
 222 BOOL WINAPI FileIconInit(BOOL bFullInit);
 223
 224 /****************************************************************************
 225  * File Menu Routines
 226  */
 227 /* FileMenu_Create nSelHeight constants */
 228 #define FM_DEFAULT_SELHEIGHT  -1
 229 #define FM_FULL_SELHEIGHT     0
 230
 231 /* FileMenu_Create flags */
 232 #define FMF_SMALL_ICONS      0x00
 233 #define FMF_LARGE_ICONS      0x08
 234 #define FMF_NO_COLUMN_BREAK  0x10
 235
 236 HMENU WINAPI FileMenu_Create(
 237     COLORREF crBorderColor,
 238     int nBorderWidth,
 239     HBITMAP hBorderBmp,
 240     int nSelHeight,
 241     UINT uFlags);
 242
 243 void WINAPI FileMenu_Destroy(HMENU hMenu);
 244
 245 /* FileMenu_AppendItem constants */
 246 #define FM_SEPARATOR       (LPCSTR)1
 247 #define FM_BLANK_ICON      -1
 248 #define FM_DEFAULT_HEIGHT  0
 249
 250 BOOL WINAPI FileMenu_AppendItem(
 251     HMENU hMenu,
 252     LPCSTR lpszText,
 253     UINT uID,
 254     int iIcon,
 255     HMENU hMenuPopup,
 256     int nItemHeight);
 257
 258 /* FileMenu_InsertUsingPidl flags */
 259 #define FMF_NO_EMPTY_ITEM      0x01
 260 #define FMF_NO_PROGRAM_GROUPS  0x04
 261
 262 /* FileMenu_InsertUsingPidl callback function */
 263 typedef void (CALLBACK *LPFNFMCALLBACK)(LPCITEMIDLIST pidlFolder, LPCITEMIDLIST pidlFile);
 264
 265 int WINAPI FileMenu_InsertUsingPidl(
 266     HMENU hMenu,
 267     UINT uID,
 268     LPCITEMIDLIST pidl,
 269     UINT uFlags,
 270     UINT uEnumFlags,
 271     LPFNFMCALLBACK lpfnCallback);
 272
 273 int WINAPI FileMenu_ReplaceUsingPidl(
 274     HMENU hMenu,
 275     UINT uID,
 276     LPCITEMIDLIST pidl,
 277     UINT uEnumFlags,
 278     LPFNFMCALLBACK lpfnCallback);
 279
 280 void WINAPI FileMenu_Invalidate(HMENU hMenu);
 281
 282 HMENU WINAPI FileMenu_FindSubMenuByPidl(
 283     HMENU hMenu,
 284     LPCITEMIDLIST pidl);
 285
 286 BOOL WINAPI FileMenu_TrackPopupMenuEx(
 287     HMENU hMenu,
 288     UINT uFlags,
 289     int x,
 290     int y,
 291     HWND hWnd,
 292     LPTPMPARAMS lptpm);
 293
 294 BOOL WINAPI FileMenu_GetLastSelectedItemPidls(
 295     UINT uReserved,
 296     LPCITEMIDLIST *ppidlFolder,
 297     LPCITEMIDLIST *ppidlItem);
 298
 299 LRESULT WINAPI FileMenu_MeasureItem(
 300     HWND hWnd,
 301     LPMEASUREITEMSTRUCT lpmis);
 302
 303 LRESULT WINAPI FileMenu_DrawItem(
 304     HWND hWnd,
 305     LPDRAWITEMSTRUCT lpdis);
 306
 307 BOOL WINAPI FileMenu_InitMenuPopup(HMENU hMenu);
 308
 309 void WINAPI FileMenu_AbortInitMenu(void);
 310
 311 LRESULT WINAPI FileMenu_HandleMenuChar(
 312     HMENU hMenu,
 313     WPARAM wParam);
 314
 315 BOOL WINAPI FileMenu_DeleteAllItems(HMENU hMenu);
 316
 317 BOOL WINAPI FileMenu_DeleteItemByCmd(
 318     HMENU hMenu,
 319     UINT uID);
 320
 321 BOOL WINAPI FileMenu_DeleteItemByIndex(
 322     HMENU hMenu,
 323     UINT uPos);
 324
 325 BOOL WINAPI FileMenu_DeleteMenuItemByFirstID(
 326     HMENU hMenu,
 327     UINT uID);
 328
 329 BOOL WINAPI FileMenu_DeleteSeparator(HMENU hMenu);
 330
 331 BOOL WINAPI FileMenu_EnableItemByCmd(
 332     HMENU hMenu,
 333     UINT uID,
 334     BOOL bEnable);
 335
 336 DWORD WINAPI FileMenu_GetItemExtent(
 337     HMENU hMenu,
 338     UINT uPos);
 339
 340 int WINAPI FileMenu_AppendFilesForPidl(
 341     HMENU hMenu,
 342     LPCITEMIDLIST pidl,
 343     BOOL bAddSeparator);
 344
 345 int WINAPI FileMenu_AddFilesForPidl(
 346     HMENU hMenu,
 347     UINT uReserved,
 348     UINT uID,
 349     LPCITEMIDLIST pidl,
 350     UINT uFlags,
 351     UINT uEnumFlags,
 352     LPFNFMCALLBACK lpfnCallback);
 353
 354 /****************************************************************************
 355  * Drag And Drop Routines
 356  */
 357
 358 HRESULT WINAPI SHRegisterDragDrop(
 359     HWND hWnd,
 360     LPDROPTARGET lpDropTarget);
 361
 362 HRESULT WINAPI SHRevokeDragDrop(HWND hWnd);
 363
 364 BOOL WINAPI DAD_DragEnter(HWND hWnd);
 365
 366 BOOL WINAPI DAD_SetDragImageFromListView(
 367     HWND hWnd,
 368     POINT pt);
 369
 370 BOOL WINAPI DAD_ShowDragImage(BOOL bShow);
 371
 372 /****************************************************************************
 373  * Path Manipulation Routines
 374  */
 375
 376 BOOL WINAPI PathAppendAW(LPVOID lpszPath1, LPCVOID lpszPath2);
 377
 378 LPVOID WINAPI PathCombineAW(LPVOID szDest, LPCVOID lpszDir, LPCVOID lpszFile);
 379
 380 LPVOID  WINAPI PathAddBackslashAW(LPVOID path);
 381
 382 LPVOID WINAPI PathBuildRootAW(LPVOID lpszPath, int drive);
 383
 384 LPVOID WINAPI PathFindExtensionAW(LPCVOID path);
 385
 386 LPVOID WINAPI PathFindFileNameAW(LPCVOID path);
 387
 388 LPVOID WINAPI PathGetExtensionAW(LPCVOID lpszPath,  DWORD void1, DWORD void2);
 389
 390 LPVOID WINAPI PathGetArgsAW(LPVOID lpszPath);
 391
 392 BOOL WINAPI PathRemoveFileSpecAW(LPVOID lpszPath);
 393
 394 void WINAPI PathRemoveBlanksAW(LPVOID lpszPath);
 395
 396 VOID  WINAPI PathQuoteSpacesAW(LPVOID path);
 397
 398 void WINAPI PathUnquoteSpacesAW(LPVOID lpszPath);
 399
 400 BOOL WINAPI PathIsUNCAW(LPCVOID lpszPath);
 401
 402 BOOL WINAPI PathIsRelativeAW(LPCVOID lpszPath);
 403
 404 BOOL WINAPI PathIsRootAW(LPCVOID x);
 405
 406 BOOL WINAPI PathIsExeAW(LPCVOID lpszPath);
 407
 408 BOOL WINAPI PathIsDirectoryAW(LPCVOID lpszPath);
 409
 410 BOOL WINAPI PathFileExistsAW(LPCVOID lpszPath);
 411
 412 BOOL WINAPI PathMatchSpecAW(LPVOID lpszPath, LPVOID lpszSpec);
 413
 414 BOOL WINAPI PathMakeUniqueNameAW(
 415     LPVOID lpszBuffer,
 416     DWORD dwBuffSize,
 417     LPCVOID lpszShortName,
 418     LPCVOID lpszLongName,
 419     LPCVOID lpszPathName);
 420
 421 BOOL WINAPI PathYetAnotherMakeUniqueName(
 422     LPWSTR lpszBuffer,
 423     LPCWSTR lpszPathName,
 424     LPCWSTR lpszShortName,
 425     LPCWSTR lpszLongName);
 426
 427 BOOL  WINAPI PathQualifyAW(LPCVOID path);
 428
 429
 430 /* PathResolve flags */
 431 #define PRF_CHECKEXISTANCE  0x01
 432 #define PRF_EXECUTABLE      0x02
 433 #define PRF_QUALIFYONPATH   0x04
 434 #define PRF_WINDOWS31       0x08
 435
 436 BOOL WINAPI PathResolveAW(LPVOID lpszPath, LPCVOID *alpszPaths, DWORD dwFlags);
 437
 438 VOID WINAPI PathSetDlgItemPathAW(HWND hDlg, int nIDDlgItem, LPCVOID lpszPath);
 439
 440 /* PathProcessCommand flags */
 441 #define PPCF_QUOTEPATH        0x01 /* implies PPCF_INCLUDEARGS */
 442 #define PPCF_INCLUDEARGS      0x02
 443 //#define PPCF_NODIRECTORIES    0x10 move to shlobj
 444 #define PPCF_DONTRESOLVE      0x20
 445 #define PPCF_PATHISRELATIVE   0x40
 446
 447 HRESULT WINAPI PathProcessCommandAW(LPCVOID lpszPath, LPVOID lpszBuff,
 448                                     DWORD dwBuffSize, DWORD dwFlags);
 449
 450 void WINAPI PathStripPathAW(LPVOID lpszPath);
 451
 452 BOOL WINAPI PathStripToRootAW(LPVOID lpszPath);
 453
 454 void WINAPI PathRemoveArgsAW(LPVOID lpszPath);
 455
 456 void WINAPI PathRemoveExtensionAW(LPVOID lpszPath);
 457
 458 int WINAPI PathParseIconLocationAW(LPVOID lpszPath);
 459
 460 BOOL WINAPI PathIsSameRootAW(LPCVOID lpszPath1, LPCVOID lpszPath2);
 461
 462 BOOL WINAPI PathFindOnPathAW(LPVOID sFile, LPCVOID *sOtherDirs);
 463
 464 /****************************************************************************
 465  * Shell File Operations error codes
 466  */
 467
 468 /* Error codes could be pre-Win32 */
 469 #define DE_SAMEFILE      0x71
 470 #define DE_MANYSRC1DEST  0x72
 471 #define DE_DIFFDIR       0x73
 472 #define DE_OPCANCELLED   0x75
 473 #define DE_DESTSUBTREE   0x76
 474 #define DE_INVALIDFILES  0x7C
 475 #define DE_DESTSAMETREE  0x7D
 476 #define DE_FLDDESTISFILE 0x7E
 477 #define DE_FILEDESTISFLD 0x80
 478
 479 /****************************************************************************
 480  * Shell Namespace Routines
 481  */
 482
 483 /* Generic structure used by several messages */
 484 typedef struct
 485 {
 486   DWORD          dwReserved;
 487   DWORD          dwReserved2;
 488   LPCITEMIDLIST  pidl;
 489   LPDWORD        lpdwUser;
 490 } SFVCBINFO, * LPSFVCBINFO;
 491 typedef const SFVCBINFO * LPCSFVCBINFO;
 492
 493 /* SFVCB_SELECTIONCHANGED structure */
 494 typedef struct
 495 {
 496   UINT           uOldState;
 497   UINT           uNewState;
 498   LPCITEMIDLIST  pidl;
 499   LPDWORD        lpdwUser;
 500 } SFVSELECTSTATE, * LPSFVSELECTSTATE;
 501 typedef const SFVSELECTSTATE * LPCSFVSELECTSTATE;
 502
 503 /* SFVCB_COPYHOOKCALLBACK structure */
 504 typedef struct
 505 {
 506   HWND    hwnd;
 507   UINT    wFunc;
 508   UINT    wFlags;
 509   LPCSTR  pszSrcFile;
 510   DWORD   dwSrcAttribs;
 511   LPCSTR  pszDestFile;
 512   DWORD   dwDestAttribs;
 513 } SFVCOPYHOOKINFO, * LPSFVCOPYHOOKINFO;
 514 typedef const SFVCOPYHOOKINFO * LPCSFVCOPYHOOKINFO;
 515
 516 /* SFVCB_GETDETAILSOF structure */
 517 typedef struct
 518 {
 519   LPCITEMIDLIST  pidl;
 520   int            fmt;
 521   int            cx;
 522   STRRET         lpText;
 523 } SFVCOLUMNINFO, * LPSFVCOLUMNINFO;
 524
 525 /****************************************************************************
 526  * Misc Stuff
 527  */
 528
 529 BOOL WINAPI
 530 RegenerateUserEnvironment(LPVOID *lpEnvironment, BOOL bUpdateSelf);
 531
 532 /* SHWaitForFileToOpen flags */
 533 #define SHWFF_ADD     0x01
 534 #define SHWFF_REMOVE  0x02
 535 #define SHWFF_WAIT    0x04
 536
 537 BOOL WINAPI SHWaitForFileToOpen(
 538     LPCITEMIDLIST pidl,
 539     DWORD dwFlags,
 540     DWORD dwTimeout);
 541
 542 WORD WINAPI ArrangeWindows(
 543     HWND hwndParent,
 544     DWORD dwReserved,
 545     LPCRECT lpRect,
 546     WORD cKids,
 547     CONST HWND * lpKids);
 548
 549 /* Flags for ShellExecCmdLine */
 550 #define SECL_NO_UI          0x2
 551 #define SECL_LOG_USAGE      0x8
 552 #define SECL_USE_IDLIST     0x10
 553 #define SECL_ALLOW_NONEXE   0x20
 554 #define SECL_RUNAS          0x40
 555
 556 HRESULT WINAPI ShellExecCmdLine(
 557     HWND hwnd,
 558     LPCWSTR pwszCommand,
 559     LPCWSTR pwszStartDir,
 560     int nShow,
 561     LPVOID pUnused,
 562     DWORD dwSeclFlags);
 563
 564 /* RegisterShellHook types */
 565 #define RSH_DEREGISTER        0
 566 #define RSH_REGISTER          1
 567 #define RSH_REGISTER_PROGMAN  2
 568 #define RSH_REGISTER_TASKMAN  3
 569
 570 BOOL WINAPI RegisterShellHook(
 571     HWND hWnd,
 572     DWORD dwType);
 573
 574 /* SHCreateDefClassObject callback function */
 575 typedef HRESULT (CALLBACK *LPFNCDCOCALLBACK)(
 576     LPUNKNOWN pUnkOuter,
 577     REFIID riidObject,
 578     LPVOID *ppvObject);
 579
 580 HRESULT WINAPI SHCreateDefClassObject(
 581     REFIID riidFactory,
 582     LPVOID *ppvFactory,
 583     LPFNCDCOCALLBACK lpfnCallback,
 584     LPDWORD lpdwUsage,
 585     REFIID riidObject);
 586
 587 void WINAPI SHFreeUnusedLibraries(void);
 588
 589 /* SHCreateLinks flags */
 590 #define SHCLF_PREFIXNAME       0x01
 591 #define SHCLF_CREATEONDESKTOP  0x02
 592
 593 HRESULT WINAPI SHCreateLinks(
 594     HWND hWnd,
 595     LPCSTR lpszDir,
 596     LPDATAOBJECT lpDataObject,
 597     UINT uFlags,
 598     LPITEMIDLIST *lppidlLinks);
 599
 600 DWORD WINAPI CheckEscapesA(LPSTR string, DWORD len);
 601 DWORD WINAPI CheckEscapesW(LPWSTR string, DWORD len);
 602
 603 /* policy functions */
 604 BOOL WINAPI SHInitRestricted(LPCVOID unused, LPCVOID inpRegKey);
 605
 606 #define CSIDL_FOLDER_MASK   0x00ff
 607
 608 /* Utility functions */
 609 #include <stdio.h>
 610
 611 #define SMC_EXEC 4
 612 INT WINAPI Shell_GetCachedImageIndex(LPCWSTR szPath, INT nIndex, UINT bSimulateDoc);
 613
 614 HRESULT WINAPI SHGetImageList(int iImageList, REFIID riid, void **ppv);
 615
 616 BOOL WINAPI GUIDFromStringW(
 617     _In_   PCWSTR psz,
 618     _Out_  LPGUID pguid
 619     );
 620
 621 /*****************************************************************************
 622  * Shell32 resources
 623  */
 624 // these resources are in shell32.dll
 625 #define IDB_GOBUTTON_NORMAL         0x0e6
 626 #define IDB_GOBUTTON_HOT            0x0e7
 627
 628 // band ids in internet toolbar
 629 #define ITBBID_MENUBAND             1
 630 #define ITBBID_BRANDBAND            5
 631 #define ITBBID_TOOLSBAND            2
 632 #define ITBBID_ADDRESSBAND          4
 633
 634 // commands in the CGID_PrivCITCommands command group handled by the internet toolbar
 635 // there seems to be some support for hiding the menubar and an auto hide feature that are
 636 // unavailable in the UI
 637 #define ITID_TEXTLABELS             3
 638 #define ITID_TOOLBARBANDSHOWN       4
 639 #define ITID_ADDRESSBANDSHOWN       5
 640 #define ITID_LINKSBANDSHOWN         6
 641 #define ITID_MENUBANDSHOWN          12
 642 #define ITID_AUTOHIDEENABLED        13
 643 #define ITID_CUSTOMIZEENABLED       20
 644 #define ITID_TOOLBARLOCKED          27
 645
 646 // commands in the CGID_BrandCmdGroup command group handled by the brand band
 647 #define BBID_STARTANIMATION         1
 648 #define BBID_STOPANIMATION          2
 649
 650 // undocumented flags for IShellMenu::SetShellFolder
 651 #define SMSET_UNKNOWN08             0x08
 652 #define SMSET_UNKNOWN10             0x10
 653
 654 // explorer tray commands
 655 #define TRAYCMD_STARTMENU           305
 656 #define TRAYCMD_RUN_DIALOG          401
 657 #define TRAYCMD_LOGOFF_DIALOG       402
 658 #define TRAYCMD_CASCADE             403
 659 #define TRAYCMD_TILE_H              404
 660 #define TRAYCMD_TILE_V              405
 661 #define TRAYCMD_TOGGLE_DESKTOP      407
 662 #define TRAYCMD_DATE_AND_TIME       408
 663 #define TRAYCMD_TASKBAR_PROPERTIES  413
 664 #define TRAYCMD_MINIMIZE_ALL        415
 665 #define TRAYCMD_RESTORE_ALL         416
 666 #define TRAYCMD_SHOW_DESKTOP        419
 667 #define TRAYCMD_SHOW_TASK_MGR       420
 668 #define TRAYCMD_CUSTOMIZE_TASKBAR   421
 669 #define TRAYCMD_LOCK_TASKBAR        424
 670 #define TRAYCMD_HELP_AND_SUPPORT    503
 671 #define TRAYCMD_CONTROL_PANEL       505
 672 #define TRAYCMD_SHUTDOWN_DIALOG     506
 673 #define TRAYCMD_PRINTERS_AND_FAXES  510
 674 #define TRAYCMD_LOCK_DESKTOP        517
 675 #define TRAYCMD_SWITCH_USER_DIALOG  5000
 676 #define TRAYCMD_SEARCH_FILES        41093
 677 #define TRAYCMD_SEARCH_COMPUTERS    41094
 678
 679 void WINAPI ShellDDEInit(BOOL bInit);
 680 DWORD WINAPI WinList_Init(void);
 681
 682 IStream* WINAPI SHGetViewStream(LPCITEMIDLIST, DWORD, LPCTSTR, LPCTSTR, LPCTSTR);
 683
 684 EXTERN_C HRESULT WINAPI SHCreateSessionKey(REGSAM samDesired, PHKEY phKey);
 685
 686 /*****************************************************************************
 687  * Shell Link
 688  */
 689 #include <pshpack1.h>
 690
 691 typedef struct tagSHELL_LINK_HEADER
 692 {
 693     /* The size of this structure (always 0x0000004C) */
 694     DWORD dwSize;
 695     /* CLSID = class identifier (always 00021401-0000-0000-C000-000000000046) */
 696     CLSID clsid;
 697     /* Flags (SHELL_LINK_DATA_FLAGS) */
 698     DWORD dwFlags;
 699     /* Informations about the link target: */
 700     DWORD dwFileAttributes;
 701     FILETIME ftCreationTime;
 702     FILETIME ftLastAccessTime;
 703     FILETIME ftLastWriteTime;
 704     DWORD nFileSizeLow; /* only the least significant 32 bits */
 705     /* The index of an icon (signed?) */
 706     DWORD nIconIndex;
 707     /* The expected window state of an application launched by the link */
 708     DWORD nShowCommand;
 709     /* The keystrokes used to launch the application */
 710     WORD wHotKey;
 711     /* Reserved (must be zero) */
 712     WORD wReserved1;
 713     DWORD dwReserved2;
 714     DWORD dwReserved3;
 715 } SHELL_LINK_HEADER, *LPSHELL_LINK_HEADER;
 716
 717 /*****************************************************************************
 718  * SHELL_LINK_INFOA/W
 719  * If cbHeaderSize == 0x0000001C then use SHELL_LINK_INFOA
 720  * If cbHeaderSize >= 0x00000024 then use SHELL_LINK_INFOW
 721  */
 722 typedef struct tagSHELL_LINK_INFOA
 723 {
 724     /* Size of the link info data */
 725     DWORD cbSize;
 726     /* Size of this structure (ANSI: = 0x0000001C) */
 727     DWORD cbHeaderSize;
 728     /* Specifies which fields are present/populated (SLI_*) */
 729     DWORD dwFlags;
 730     /* Offset of the VolumeID field (SHELL_LINK_INFO_VOLUME_ID) */
 731     DWORD cbVolumeIDOffset;
 732     /* Offset of the LocalBasePath field (ANSI, NULL-terminated string) */
 733     DWORD cbLocalBasePathOffset;
 734     /* Offset of the CommonNetworkRelativeLink field (SHELL_LINK_INFO_CNR_LINK) */
 735     DWORD cbCommonNetworkRelativeLinkOffset;
 736     /* Offset of the CommonPathSuffix field (ANSI, NULL-terminated string) */
 737     DWORD cbCommonPathSuffixOffset;
 738 } SHELL_LINK_INFOA, *LPSHELL_LINK_INFOA;
 739
 740 typedef struct tagSHELL_LINK_INFOW
 741 {
 742     /* Size of the link info data */
 743     DWORD cbSize;
 744     /* Size of this structure (Unicode: >= 0x00000024) */
 745     DWORD cbHeaderSize;
 746     /* Specifies which fields are present/populated (SLI_*) */
 747     DWORD dwFlags;
 748     /* Offset of the VolumeID field (SHELL_LINK_INFO_VOLUME_ID) */
 749     DWORD cbVolumeIDOffset;
 750     /* Offset of the LocalBasePath field (ANSI, NULL-terminated string) */
 751     DWORD cbLocalBasePathOffset;
 752     /* Offset of the CommonNetworkRelativeLink field (SHELL_LINK_INFO_CNR_LINK) */
 753     DWORD cbCommonNetworkRelativeLinkOffset;
 754     /* Offset of the CommonPathSuffix field (ANSI, NULL-terminated string) */
 755     DWORD cbCommonPathSuffixOffset;
 756     /* Offset of the LocalBasePathUnicode field (Unicode, NULL-terminated string) */
 757     DWORD cbLocalBasePathUnicodeOffset;
 758     /* Offset of the CommonPathSuffixUnicode field (Unicode, NULL-terminated string) */
 759     DWORD cbCommonPathSuffixUnicodeOffset;
 760 } SHELL_LINK_INFOW, *LPSHELL_LINK_INFOW;
 761
 762 /* VolumeID, LocalBasePath, LocalBasePathUnicode(cbHeaderSize >= 0x24) are present */
 763 #define SLI_VALID_LOCAL   0x00000001
 764 /* CommonNetworkRelativeLink is present */
 765 #define SLI_VALID_NETWORK 0x00000002
 766
 767 /*****************************************************************************
 768  * SHELL_LINK_INFO_VOLUME_IDA/W
 769  * If cbVolumeLabelOffset != 0x00000014 (should be 0x00000010) then use
 770  * SHELL_LINK_INFO_VOLUME_IDA
 771  * If cbVolumeLabelOffset == 0x00000014 then use SHELL_LINK_INFO_VOLUME_IDW
 772  */
 773 typedef struct tagSHELL_LINK_INFO_VOLUME_IDA
 774 {
 775     /* Size of the VolumeID field (> 0x00000010) */
 776     DWORD cbSize;
 777     /* Drive type of the drive the link target is stored on (DRIVE_*) */
 778     DWORD dwDriveType;
 779     /* Serial number of the volume the link target is stored on */
 780     DWORD nDriveSerialNumber;
 781     /* Offset of the volume label (ANSI, NULL-terminated string).
 782        Must be != 0x00000014 (see tagSHELL_LINK_INFO_VOLUME_IDW) */
 783     DWORD cbVolumeLabelOffset;
 784 } SHELL_LINK_INFO_VOLUME_IDA, *LPSHELL_LINK_INFO_VOLUME_IDA;
 785
 786 typedef struct tagSHELL_LINK_INFO_VOLUME_IDW
 787 {
 788     /* Size of the VolumeID field (> 0x00000010) */
 789     DWORD cbSize;
 790     /* Drive type of the drive the link target is stored on (DRIVE_*) */
 791     DWORD dwDriveType;
 792     /* Serial number of the volume the link target is stored on */
 793     DWORD nDriveSerialNumber;
 794     /* Offset of the volume label (ANSI, NULL-terminated string).
 795        If the value of this field is 0x00000014, ignore it and use
 796        cbVolumeLabelUnicodeOffset! */
 797     DWORD cbVolumeLabelOffset;
 798     /* Offset of the volume label (Unicode, NULL-terminated string).
 799        If the value of the VolumeLabelOffset field is not 0x00000014,
 800        this field must be ignored (==> it doesn't exists ==> ANSI). */
 801     DWORD cbVolumeLabelUnicodeOffset;
 802 } SHELL_LINK_INFO_VOLUME_IDW, *LPSHELL_LINK_INFO_VOLUME_IDW;
 803
 804 /*****************************************************************************
 805  * SHELL_LINK_INFO_CNR_LINKA/W (CNR = Common Network Relative)
 806  * If cbNetNameOffset == 0x00000014 then use SHELL_LINK_INFO_CNR_LINKA
 807  * If cbNetNameOffset > 0x00000014 then use SHELL_LINK_INFO_CNR_LINKW
 808  */
 809 typedef struct tagSHELL_LINK_INFO_CNR_LINKA
 810 {
 811     /* Size of the CommonNetworkRelativeLink field (>= 0x00000014) */
 812     DWORD cbSize;
 813     /* Specifies which fields are present/populated (SLI_CNR_*) */
 814     DWORD dwFlags;
 815     /* Offset of the NetName field (ANSI, NULL–terminated string) */
 816     DWORD cbNetNameOffset;
 817     /* Offset of the DeviceName field (ANSI, NULL–terminated string) */
 818     DWORD cbDeviceNameOffset;
 819     /* Type of the network provider (WNNC_NET_* defined in winnetwk.h) */
 820     DWORD dwNetworkProviderType;
 821 } SHELL_LINK_INFO_CNR_LINKA, *LPSHELL_LINK_INFO_CNR_LINKA;
 822
 823 typedef struct tagSHELL_LINK_INFO_CNR_LINKW
 824 {
 825     /* Size of the CommonNetworkRelativeLink field (>= 0x00000014) */
 826     DWORD cbSize;
 827     /* Specifies which fields are present/populated (SLI_CNR_*) */
 828     DWORD dwFlags;
 829     /* Offset of the NetName field (ANSI, NULL–terminated string) */
 830     DWORD cbNetNameOffset;
 831     /* Offset of the DeviceName field (ANSI, NULL–terminated string) */
 832     DWORD cbDeviceNameOffset;
 833     /* Type of the network provider (WNNC_NET_* defined in winnetwk.h) */
 834     DWORD dwNetworkProviderType;
 835     /* Offset of the NetNameUnicode field (Unicode, NULL–terminated string) */
 836     DWORD cbNetNameUnicodeOffset;
 837     /* Offset of the DeviceNameUnicode field (Unicode, NULL–terminated string) */
 838     DWORD cbDeviceNameUnicodeOffset;
 839 } SHELL_LINK_INFO_CNR_LINKW, *LPSHELL_LINK_INFO_CNR_LINKW;
 840
 841 /* DeviceName is present */
 842 #define SLI_CNR_VALID_DEVICE   0x00000001
 843 /* NetworkProviderType is present */
 844 #define SLI_CNR_VALID_NET_TYPE 0x00000002
 845
 846 /*****************************************************************************
 847  * Shell Link Extra Data (IShellLinkDataList)
 848  */
 849 typedef struct tagEXP_TRACKER
 850 {
 851     /* .cbSize = 0x00000060, .dwSignature = 0xa0000003 */
 852     DATABLOCK_HEADER dbh;
 853     /* Length >= 0x00000058 */
 854     DWORD nLength;
 855     /* Must be 0x00000000 */
 856     DWORD nVersion;
 857     /* NetBIOS name (ANSI, unused bytes are set to zero) */
 858     CHAR szMachineID[16]; /* "variable" >= 16 (?) */
 859     /* Some GUIDs for the Link Tracking service (from the FS?) */
 860     GUID guidDroidVolume;
 861     GUID guidDroidObject;
 862     GUID guidDroidBirthVolume;
 863     GUID guidDroidBirthObject;
 864 } EXP_TRACKER, *LPEXP_TRACKER;
 865
 866 typedef struct tagEXP_SHIM
 867 {
 868     /* .cbSize >= 0x00000088, .dwSignature = 0xa0000008 */
 869     DATABLOCK_HEADER dbh;
 870     /* Name of a shim layer to apply (Unicode, unused bytes are set to zero) */
 871     WCHAR szwLayerName[64]; /* "variable" >= 64 */
 872 } EXP_SHIM, *LPEXP_SHIM;
 873
 874 typedef struct tagEXP_KNOWN_FOLDER
 875 {
 876     /* .cbSize = 0x0000001c, .dwSignature = 0xa000000b */
 877     DATABLOCK_HEADER dbh;
 878     /* A GUID value that identifies a known folder */
 879     GUID guidKnownFolder;
 880     /* Specifies the location of the ItemID of the first child
 881        segment of the IDList specified by guidKnownFolder */
 882     DWORD cbOffset;
 883 } EXP_KNOWN_FOLDER, *LPEXP_KNOWN_FOLDER;
 884
 885 typedef struct tagEXP_VISTA_ID_LIST
 886 {
 887     /* .cbSize >= 0x0000000a, .dwSignature = 0xa000000c */
 888     DATABLOCK_HEADER dbh;
 889     /* Specifies an alternate IDList that can be used instead
 890        of the "normal" IDList (SLDF_HAS_ID_LIST) */
 891     /* LPITEMIDLIST pIDList; (variable) */
 892 } EXP_VISTA_ID_LIST, *LPEXP_VISTA_ID_LIST;
 893
 894 #define EXP_TRACKER_SIG       0xa0000003
 895 #define EXP_SHIM_SIG          0xa0000008
 896 #define EXP_KNOWN_FOLDER_SIG  0xa000000b
 897 #define EXP_VISTA_ID_LIST_SIG 0xa000000c
 898
 899 /* Not compatible yet */
 900 typedef struct SFVM_CUSTOMVIEWINFO_DATA
 901 {
 902     ULONG cbSize;
 903     HBITMAP hbmBack;
 904     COLORREF clrText;
 905     COLORREF clrTextBack;
 906 } SFVM_CUSTOMVIEWINFO_DATA, *LPSFVM_CUSTOMVIEWINFO_DATA;
 907
 908 #include <poppack.h>
 909
 910 #ifdef __cplusplus
 911 } /* extern "C" */
 912 #endif /* defined(__cplusplus) */
 913
 914 #endif /* __WINE_UNDOCSHELL_H */