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 - SHFileOperationA/W
 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_ROOTDIR          0x74
 473 #define DE_OPCANCELLED      0x75
 474 #define DE_DESTSUBTREE      0x76
 475 #define DE_ACCESSDENIEDSRC  0x78
 476 #define DE_PATHTOODEEP      0x79
 477 #define DE_MANYDEST         0x7A
 478 #define DE_INVALIDFILES     0x7C
 479 #define DE_DESTSAMETREE     0x7D
 480 #define DE_FLDDESTISFILE    0x7E
 481 #define DE_FILEDESTISFLD    0x80
 482 #define DE_FILENAMETOOLONG  0x81
 483 #define DE_DEST_IS_CDROM    0x82
 484 #define DE_DEST_IS_DVD      0x83
 485 #define DE_DEST_IS_CDRECORD 0x84
 486 #define DE_FILE_TOO_LARGE   0x85
 487 #define DE_SRC_IS_CDROM     0x86
 488 #define DE_SRC_IS_DVD       0x87
 489 #define DE_SRC_IS_CDRECORD  0x88
 490 // #define DE_ERROR_MAX
 491 #define ERRORONDEST         0x10000
 492
 493 /****************************************************************************
 494  * Shell Namespace Routines
 495  */
 496
 497 /* Generic structure used by several messages */
 498 typedef struct
 499 {
 500   DWORD          dwReserved;
 501   DWORD          dwReserved2;
 502   LPCITEMIDLIST  pidl;
 503   LPDWORD        lpdwUser;
 504 } SFVCBINFO, * LPSFVCBINFO;
 505 typedef const SFVCBINFO * LPCSFVCBINFO;
 506
 507 /* SFVCB_SELECTIONCHANGED structure */
 508 typedef struct
 509 {
 510   UINT           uOldState;
 511   UINT           uNewState;
 512   LPCITEMIDLIST  pidl;
 513   LPDWORD        lpdwUser;
 514 } SFVSELECTSTATE, * LPSFVSELECTSTATE;
 515 typedef const SFVSELECTSTATE * LPCSFVSELECTSTATE;
 516
 517 /* SFVCB_COPYHOOKCALLBACK structure */
 518 typedef struct
 519 {
 520   HWND    hwnd;
 521   UINT    wFunc;
 522   UINT    wFlags;
 523   LPCSTR  pszSrcFile;
 524   DWORD   dwSrcAttribs;
 525   LPCSTR  pszDestFile;
 526   DWORD   dwDestAttribs;
 527 } SFVCOPYHOOKINFO, * LPSFVCOPYHOOKINFO;
 528 typedef const SFVCOPYHOOKINFO * LPCSFVCOPYHOOKINFO;
 529
 530 /* SFVCB_GETDETAILSOF structure */
 531 typedef struct
 532 {
 533   LPCITEMIDLIST  pidl;
 534   int            fmt;
 535   int            cx;
 536   STRRET         lpText;
 537 } SFVCOLUMNINFO, * LPSFVCOLUMNINFO;
 538
 539 /****************************************************************************
 540  * Misc Stuff
 541  */
 542
 543 BOOL WINAPI
 544 RegenerateUserEnvironment(LPVOID *lpEnvironment, BOOL bUpdateSelf);
 545
 546 /* SHWaitForFileToOpen flags */
 547 #define SHWFF_ADD     0x01
 548 #define SHWFF_REMOVE  0x02
 549 #define SHWFF_WAIT    0x04
 550
 551 BOOL WINAPI SHWaitForFileToOpen(
 552     LPCITEMIDLIST pidl,
 553     DWORD dwFlags,
 554     DWORD dwTimeout);
 555
 556 WORD WINAPI ArrangeWindows(
 557     HWND hwndParent,
 558     DWORD dwReserved,
 559     LPCRECT lpRect,
 560     WORD cKids,
 561     CONST HWND * lpKids);
 562
 563 /* Flags for ShellExecCmdLine */
 564 #define SECL_NO_UI          0x2
 565 #define SECL_LOG_USAGE      0x8
 566 #define SECL_USE_IDLIST     0x10
 567 #define SECL_ALLOW_NONEXE   0x20
 568 #define SECL_RUNAS          0x40
 569
 570 HRESULT WINAPI ShellExecCmdLine(
 571     HWND hwnd,
 572     LPCWSTR pwszCommand,
 573     LPCWSTR pwszStartDir,
 574     int nShow,
 575     LPVOID pUnused,
 576     DWORD dwSeclFlags);
 577
 578 /* RegisterShellHook types */
 579 #define RSH_DEREGISTER        0
 580 #define RSH_REGISTER          1
 581 #define RSH_REGISTER_PROGMAN  2
 582 #define RSH_REGISTER_TASKMAN  3
 583
 584 BOOL WINAPI RegisterShellHook(
 585     HWND hWnd,
 586     DWORD dwType);
 587
 588 /* SHCreateDefClassObject callback function */
 589 typedef HRESULT (CALLBACK *LPFNCDCOCALLBACK)(
 590     LPUNKNOWN pUnkOuter,
 591     REFIID riidObject,
 592     LPVOID *ppvObject);
 593
 594 HRESULT WINAPI SHCreateDefClassObject(
 595     REFIID riidFactory,
 596     LPVOID *ppvFactory,
 597     LPFNCDCOCALLBACK lpfnCallback,
 598     LPDWORD lpdwUsage,
 599     REFIID riidObject);
 600
 601 void WINAPI SHFreeUnusedLibraries(void);
 602
 603 /* SHCreateLinks flags */
 604 #define SHCLF_PREFIXNAME       0x01
 605 #define SHCLF_CREATEONDESKTOP  0x02
 606
 607 HRESULT WINAPI SHCreateLinks(
 608     HWND hWnd,
 609     LPCSTR lpszDir,
 610     LPDATAOBJECT lpDataObject,
 611     UINT uFlags,
 612     LPITEMIDLIST *lppidlLinks);
 613
 614 DWORD WINAPI CheckEscapesA(LPSTR string, DWORD len);
 615 DWORD WINAPI CheckEscapesW(LPWSTR string, DWORD len);
 616
 617 /* policy functions */
 618 BOOL WINAPI SHInitRestricted(LPCVOID unused, LPCVOID inpRegKey);
 619
 620 #define CSIDL_FOLDER_MASK   0x00ff
 621
 622 /* Utility functions */
 623 #include <stdio.h>
 624
 625 #define SMC_EXEC 4
 626 INT WINAPI Shell_GetCachedImageIndex(LPCWSTR szPath, INT nIndex, UINT bSimulateDoc);
 627
 628 HRESULT WINAPI SHGetImageList(int iImageList, REFIID riid, void **ppv);
 629
 630 BOOL WINAPI GUIDFromStringW(
 631     _In_   PCWSTR psz,
 632     _Out_  LPGUID pguid
 633     );
 634
 635 /*****************************************************************************
 636  * Shell32 resources
 637  */
 638 // these resources are in shell32.dll
 639 #define IDB_GOBUTTON_NORMAL         0x0e6
 640 #define IDB_GOBUTTON_HOT            0x0e7
 641
 642 // band ids in internet toolbar
 643 #define ITBBID_MENUBAND             1
 644 #define ITBBID_BRANDBAND            5
 645 #define ITBBID_TOOLSBAND            2
 646 #define ITBBID_ADDRESSBAND          4
 647
 648 // commands in the CGID_PrivCITCommands command group handled by the internet toolbar
 649 // there seems to be some support for hiding the menubar and an auto hide feature that are
 650 // unavailable in the UI
 651 #define ITID_TEXTLABELS             3
 652 #define ITID_TOOLBARBANDSHOWN       4
 653 #define ITID_ADDRESSBANDSHOWN       5
 654 #define ITID_LINKSBANDSHOWN         6
 655 #define ITID_MENUBANDSHOWN          12
 656 #define ITID_AUTOHIDEENABLED        13
 657 #define ITID_CUSTOMIZEENABLED       20
 658 #define ITID_TOOLBARLOCKED          27
 659
 660 // commands in the CGID_BrandCmdGroup command group handled by the brand band
 661 #define BBID_STARTANIMATION         1
 662 #define BBID_STOPANIMATION          2
 663
 664 // undocumented flags for IShellMenu::SetShellFolder
 665 #define SMSET_UNKNOWN08             0x08
 666 #define SMSET_UNKNOWN10             0x10
 667
 668 // explorer tray commands
 669 #define TRAYCMD_STARTMENU           305
 670 #define TRAYCMD_RUN_DIALOG          401
 671 #define TRAYCMD_LOGOFF_DIALOG       402
 672 #define TRAYCMD_CASCADE             403
 673 #define TRAYCMD_TILE_H              404
 674 #define TRAYCMD_TILE_V              405
 675 #define TRAYCMD_TOGGLE_DESKTOP      407
 676 #define TRAYCMD_DATE_AND_TIME       408
 677 #define TRAYCMD_TASKBAR_PROPERTIES  413
 678 #define TRAYCMD_MINIMIZE_ALL        415
 679 #define TRAYCMD_RESTORE_ALL         416
 680 #define TRAYCMD_SHOW_DESKTOP        419
 681 #define TRAYCMD_SHOW_TASK_MGR       420
 682 #define TRAYCMD_CUSTOMIZE_TASKBAR   421
 683 #define TRAYCMD_LOCK_TASKBAR        424
 684 #define TRAYCMD_HELP_AND_SUPPORT    503
 685 #define TRAYCMD_CONTROL_PANEL       505
 686 #define TRAYCMD_SHUTDOWN_DIALOG     506
 687 #define TRAYCMD_PRINTERS_AND_FAXES  510
 688 #define TRAYCMD_LOCK_DESKTOP        517
 689 #define TRAYCMD_SWITCH_USER_DIALOG  5000
 690 #define TRAYCMD_SEARCH_FILES        41093
 691 #define TRAYCMD_SEARCH_COMPUTERS    41094
 692
 693 // Explorer Tray Application Bar Data Message Commands
 694 #define TABDMC_APPBAR     0
 695 #define TABDMC_NOTIFY     1
 696 #define TABDMC_LOADINPROC 2
 697
 698 void WINAPI ShellDDEInit(BOOL bInit);
 699 DWORD WINAPI WinList_Init(void);
 700
 701 IStream* WINAPI SHGetViewStream(LPCITEMIDLIST, DWORD, LPCTSTR, LPCTSTR, LPCTSTR);
 702
 703 EXTERN_C HRESULT WINAPI SHCreateSessionKey(REGSAM samDesired, PHKEY phKey);
 704
 705 /*****************************************************************************
 706  * INVALID_FILETITLE_CHARACTERS
 707  */
 708
 709 #define INVALID_FILETITLE_CHARACTERSA "\\/:*?\"<>|"
 710 #define INVALID_FILETITLE_CHARACTERSW L"\\/:*?\"<>|"
 711
 712 #ifdef UNICODE
 713     #define INVALID_FILETITLE_CHARACTERS INVALID_FILETITLE_CHARACTERSW
 714 #else
 715     #define INVALID_FILETITLE_CHARACTERS INVALID_FILETITLE_CHARACTERSA
 716 #endif
 717
 718 /*****************************************************************************
 719  * Shell Link
 720  */
 721 #include <pshpack1.h>
 722
 723 typedef struct tagSHELL_LINK_HEADER
 724 {
 725     /* The size of this structure (always 0x0000004C) */
 726     DWORD dwSize;
 727     /* CLSID = class identifier (always 00021401-0000-0000-C000-000000000046) */
 728     CLSID clsid;
 729     /* Flags (SHELL_LINK_DATA_FLAGS) */
 730     DWORD dwFlags;
 731     /* Informations about the link target: */
 732     DWORD dwFileAttributes;
 733     FILETIME ftCreationTime;
 734     FILETIME ftLastAccessTime;
 735     FILETIME ftLastWriteTime;
 736     DWORD nFileSizeLow; /* only the least significant 32 bits */
 737     /* The index of an icon (signed?) */
 738     DWORD nIconIndex;
 739     /* The expected window state of an application launched by the link */
 740     DWORD nShowCommand;
 741     /* The keystrokes used to launch the application */
 742     WORD wHotKey;
 743     /* Reserved (must be zero) */
 744     WORD wReserved1;
 745     DWORD dwReserved2;
 746     DWORD dwReserved3;
 747 } SHELL_LINK_HEADER, *LPSHELL_LINK_HEADER;
 748
 749 /*****************************************************************************
 750  * SHELL_LINK_INFOA/W
 751  * If cbHeaderSize == 0x0000001C then use SHELL_LINK_INFOA
 752  * If cbHeaderSize >= 0x00000024 then use SHELL_LINK_INFOW
 753  */
 754 typedef struct tagSHELL_LINK_INFOA
 755 {
 756     /* Size of the link info data */
 757     DWORD cbSize;
 758     /* Size of this structure (ANSI: = 0x0000001C) */
 759     DWORD cbHeaderSize;
 760     /* Specifies which fields are present/populated (SLI_*) */
 761     DWORD dwFlags;
 762     /* Offset of the VolumeID field (SHELL_LINK_INFO_VOLUME_ID) */
 763     DWORD cbVolumeIDOffset;
 764     /* Offset of the LocalBasePath field (ANSI, NULL-terminated string) */
 765     DWORD cbLocalBasePathOffset;
 766     /* Offset of the CommonNetworkRelativeLink field (SHELL_LINK_INFO_CNR_LINK) */
 767     DWORD cbCommonNetworkRelativeLinkOffset;
 768     /* Offset of the CommonPathSuffix field (ANSI, NULL-terminated string) */
 769     DWORD cbCommonPathSuffixOffset;
 770 } SHELL_LINK_INFOA, *LPSHELL_LINK_INFOA;
 771
 772 typedef struct tagSHELL_LINK_INFOW
 773 {
 774     /* Size of the link info data */
 775     DWORD cbSize;
 776     /* Size of this structure (Unicode: >= 0x00000024) */
 777     DWORD cbHeaderSize;
 778     /* Specifies which fields are present/populated (SLI_*) */
 779     DWORD dwFlags;
 780     /* Offset of the VolumeID field (SHELL_LINK_INFO_VOLUME_ID) */
 781     DWORD cbVolumeIDOffset;
 782     /* Offset of the LocalBasePath field (ANSI, NULL-terminated string) */
 783     DWORD cbLocalBasePathOffset;
 784     /* Offset of the CommonNetworkRelativeLink field (SHELL_LINK_INFO_CNR_LINK) */
 785     DWORD cbCommonNetworkRelativeLinkOffset;
 786     /* Offset of the CommonPathSuffix field (ANSI, NULL-terminated string) */
 787     DWORD cbCommonPathSuffixOffset;
 788     /* Offset of the LocalBasePathUnicode field (Unicode, NULL-terminated string) */
 789     DWORD cbLocalBasePathUnicodeOffset;
 790     /* Offset of the CommonPathSuffixUnicode field (Unicode, NULL-terminated string) */
 791     DWORD cbCommonPathSuffixUnicodeOffset;
 792 } SHELL_LINK_INFOW, *LPSHELL_LINK_INFOW;
 793
 794 /* VolumeID, LocalBasePath, LocalBasePathUnicode(cbHeaderSize >= 0x24) are present */
 795 #define SLI_VALID_LOCAL   0x00000001
 796 /* CommonNetworkRelativeLink is present */
 797 #define SLI_VALID_NETWORK 0x00000002
 798
 799 /*****************************************************************************
 800  * SHELL_LINK_INFO_VOLUME_IDA/W
 801  * If cbVolumeLabelOffset != 0x00000014 (should be 0x00000010) then use
 802  * SHELL_LINK_INFO_VOLUME_IDA
 803  * If cbVolumeLabelOffset == 0x00000014 then use SHELL_LINK_INFO_VOLUME_IDW
 804  */
 805 typedef struct tagSHELL_LINK_INFO_VOLUME_IDA
 806 {
 807     /* Size of the VolumeID field (> 0x00000010) */
 808     DWORD cbSize;
 809     /* Drive type of the drive the link target is stored on (DRIVE_*) */
 810     DWORD dwDriveType;
 811     /* Serial number of the volume the link target is stored on */
 812     DWORD nDriveSerialNumber;
 813     /* Offset of the volume label (ANSI, NULL-terminated string).
 814        Must be != 0x00000014 (see tagSHELL_LINK_INFO_VOLUME_IDW) */
 815     DWORD cbVolumeLabelOffset;
 816 } SHELL_LINK_INFO_VOLUME_IDA, *LPSHELL_LINK_INFO_VOLUME_IDA;
 817
 818 typedef struct tagSHELL_LINK_INFO_VOLUME_IDW
 819 {
 820     /* Size of the VolumeID field (> 0x00000010) */
 821     DWORD cbSize;
 822     /* Drive type of the drive the link target is stored on (DRIVE_*) */
 823     DWORD dwDriveType;
 824     /* Serial number of the volume the link target is stored on */
 825     DWORD nDriveSerialNumber;
 826     /* Offset of the volume label (ANSI, NULL-terminated string).
 827        If the value of this field is 0x00000014, ignore it and use
 828        cbVolumeLabelUnicodeOffset! */
 829     DWORD cbVolumeLabelOffset;
 830     /* Offset of the volume label (Unicode, NULL-terminated string).
 831        If the value of the VolumeLabelOffset field is not 0x00000014,
 832        this field must be ignored (==> it doesn't exists ==> ANSI). */
 833     DWORD cbVolumeLabelUnicodeOffset;
 834 } SHELL_LINK_INFO_VOLUME_IDW, *LPSHELL_LINK_INFO_VOLUME_IDW;
 835
 836 /*****************************************************************************
 837  * SHELL_LINK_INFO_CNR_LINKA/W (CNR = Common Network Relative)
 838  * If cbNetNameOffset == 0x00000014 then use SHELL_LINK_INFO_CNR_LINKA
 839  * If cbNetNameOffset > 0x00000014 then use SHELL_LINK_INFO_CNR_LINKW
 840  */
 841 typedef struct tagSHELL_LINK_INFO_CNR_LINKA
 842 {
 843     /* Size of the CommonNetworkRelativeLink field (>= 0x00000014) */
 844     DWORD cbSize;
 845     /* Specifies which fields are present/populated (SLI_CNR_*) */
 846     DWORD dwFlags;
 847     /* Offset of the NetName field (ANSI, NULL–terminated string) */
 848     DWORD cbNetNameOffset;
 849     /* Offset of the DeviceName field (ANSI, NULL–terminated string) */
 850     DWORD cbDeviceNameOffset;
 851     /* Type of the network provider (WNNC_NET_* defined in winnetwk.h) */
 852     DWORD dwNetworkProviderType;
 853 } SHELL_LINK_INFO_CNR_LINKA, *LPSHELL_LINK_INFO_CNR_LINKA;
 854
 855 typedef struct tagSHELL_LINK_INFO_CNR_LINKW
 856 {
 857     /* Size of the CommonNetworkRelativeLink field (>= 0x00000014) */
 858     DWORD cbSize;
 859     /* Specifies which fields are present/populated (SLI_CNR_*) */
 860     DWORD dwFlags;
 861     /* Offset of the NetName field (ANSI, NULL–terminated string) */
 862     DWORD cbNetNameOffset;
 863     /* Offset of the DeviceName field (ANSI, NULL–terminated string) */
 864     DWORD cbDeviceNameOffset;
 865     /* Type of the network provider (WNNC_NET_* defined in winnetwk.h) */
 866     DWORD dwNetworkProviderType;
 867     /* Offset of the NetNameUnicode field (Unicode, NULL–terminated string) */
 868     DWORD cbNetNameUnicodeOffset;
 869     /* Offset of the DeviceNameUnicode field (Unicode, NULL–terminated string) */
 870     DWORD cbDeviceNameUnicodeOffset;
 871 } SHELL_LINK_INFO_CNR_LINKW, *LPSHELL_LINK_INFO_CNR_LINKW;
 872
 873 /* DeviceName is present */
 874 #define SLI_CNR_VALID_DEVICE   0x00000001
 875 /* NetworkProviderType is present */
 876 #define SLI_CNR_VALID_NET_TYPE 0x00000002
 877
 878 /*****************************************************************************
 879  * Shell Link Extra Data (IShellLinkDataList)
 880  */
 881 typedef struct tagEXP_TRACKER
 882 {
 883     /* .cbSize = 0x00000060, .dwSignature = 0xa0000003 */
 884     DATABLOCK_HEADER dbh;
 885     /* Length >= 0x00000058 */
 886     DWORD nLength;
 887     /* Must be 0x00000000 */
 888     DWORD nVersion;
 889     /* NetBIOS name (ANSI, unused bytes are set to zero) */
 890     CHAR szMachineID[16]; /* "variable" >= 16 (?) */
 891     /* Some GUIDs for the Link Tracking service (from the FS?) */
 892     GUID guidDroidVolume;
 893     GUID guidDroidObject;
 894     GUID guidDroidBirthVolume;
 895     GUID guidDroidBirthObject;
 896 } EXP_TRACKER, *LPEXP_TRACKER;
 897
 898 typedef struct tagEXP_SHIM
 899 {
 900     /* .cbSize >= 0x00000088, .dwSignature = 0xa0000008 */
 901     DATABLOCK_HEADER dbh;
 902     /* Name of a shim layer to apply (Unicode, unused bytes are set to zero) */
 903     WCHAR szwLayerName[64]; /* "variable" >= 64 */
 904 } EXP_SHIM, *LPEXP_SHIM;
 905
 906 typedef struct tagEXP_KNOWN_FOLDER
 907 {
 908     /* .cbSize = 0x0000001c, .dwSignature = 0xa000000b */
 909     DATABLOCK_HEADER dbh;
 910     /* A GUID value that identifies a known folder */
 911     GUID guidKnownFolder;
 912     /* Specifies the location of the ItemID of the first child
 913        segment of the IDList specified by guidKnownFolder */
 914     DWORD cbOffset;
 915 } EXP_KNOWN_FOLDER, *LPEXP_KNOWN_FOLDER;
 916
 917 typedef struct tagEXP_VISTA_ID_LIST
 918 {
 919     /* .cbSize >= 0x0000000a, .dwSignature = 0xa000000c */
 920     DATABLOCK_HEADER dbh;
 921     /* Specifies an alternate IDList that can be used instead
 922        of the "normal" IDList (SLDF_HAS_ID_LIST) */
 923     /* LPITEMIDLIST pIDList; (variable) */
 924 } EXP_VISTA_ID_LIST, *LPEXP_VISTA_ID_LIST;
 925
 926 #define EXP_TRACKER_SIG       0xa0000003
 927 #define EXP_SHIM_SIG          0xa0000008
 928 #define EXP_KNOWN_FOLDER_SIG  0xa000000b
 929 #define EXP_VISTA_ID_LIST_SIG 0xa000000c
 930
 931 /* Not compatible yet */
 932 typedef struct SFVM_CUSTOMVIEWINFO_DATA
 933 {
 934     ULONG cbSize;
 935     HBITMAP hbmBack;
 936     COLORREF clrText;
 937     COLORREF clrTextBack;
 938 } SFVM_CUSTOMVIEWINFO_DATA, *LPSFVM_CUSTOMVIEWINFO_DATA;
 939
 940 #include <poppack.h>
 941
 942 #ifdef __cplusplus
 943 } /* extern "C" */
 944 #endif /* defined(__cplusplus) */
 945
 946 #endif /* __WINE_UNDOCSHELL_H */