git.oblomov.eu Git - wine/blob - dlls/shell32/shellord.c

   1 /*
   2  * The parameters of many functions changes between different OS versions
   3  * (NT uses Unicode strings, 95 uses ASCII strings)
   4  *
   5  * Copyright 1997 Marcus Meissner
   6  *           1998 Jürgen Schmied
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2.1 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  */
  22 #include "config.h"
  23
  24 #include <string.h>
  25 #include <stdarg.h>
  26 #include <stdio.h>
  27
  28 #define COBJMACROS
  29
  30 #include "winerror.h"
  31 #include "windef.h"
  32 #include "winbase.h"
  33 #include "winreg.h"
  34 #include "wine/debug.h"
  35 #include "winnls.h"
  36
  37 #include "shellapi.h"
  38 #include "objbase.h"
  39 #include "shlguid.h"
  40 #include "wingdi.h"
  41 #include "winuser.h"
  42 #include "shlobj.h"
  43 #include "shell32_main.h"
  44 #include "undocshell.h"
  45 #include "pidl.h"
  46 #include "shlwapi.h"
  47 #include "commdlg.h"
  48
  49 WINE_DEFAULT_DEBUG_CHANNEL(shell);
  50 WINE_DECLARE_DEBUG_CHANNEL(pidl);
  51
  52 /* FIXME: !!! move CREATEMRULIST and flags to header file !!! */
  53 /*        !!! it is in both here and comctl32undoc.c      !!! */
  54 typedef struct tagCREATEMRULIST
  55 {
  56     DWORD  cbSize;        /* size of struct */
  57     DWORD  nMaxItems;     /* max no. of items in list */
  58     DWORD  dwFlags;       /* see below */
  59     HKEY   hKey;          /* root reg. key under which list is saved */
  60     LPCSTR lpszSubKey;    /* reg. subkey */
  61     PROC   lpfnCompare;   /* item compare proc */
  62 } CREATEMRULISTA, *LPCREATEMRULISTA;
  63
  64 /* dwFlags */
  65 #define MRUF_STRING_LIST  0 /* list will contain strings */
  66 #define MRUF_BINARY_LIST  1 /* list will contain binary data */
  67 #define MRUF_DELAYED_SAVE 2 /* only save list order to reg. is FreeMRUList */
  68
  69 extern HANDLE WINAPI CreateMRUListA(LPCREATEMRULISTA lpcml);
  70 extern DWORD  WINAPI FreeMRUList(HANDLE hMRUList);
  71 extern INT    WINAPI AddMRUData(HANDLE hList, LPCVOID lpData, DWORD cbData);
  72 extern INT    WINAPI FindMRUData(HANDLE hList, LPCVOID lpData, DWORD cbData, LPINT lpRegNum);
  73 extern INT    WINAPI EnumMRUListA(HANDLE hList, INT nItemPos, LPVOID lpBuffer, DWORD nBufferSize);
  74
  75
  76 /* Get a function pointer from a DLL handle */
  77 #define GET_FUNC(func, module, name, fail) \
  78   do { \
  79     if (!func) { \
  80       if (!SHELL32_h##module && !(SHELL32_h##module = LoadLibraryA(#module ".dll"))) return fail; \
  81       func = (void*)GetProcAddress(SHELL32_h##module, name); \
  82       if (!func) return fail; \
  83     } \
  84   } while (0)
  85
  86 /* Function pointers for GET_FUNC macro */
  87 static HMODULE SHELL32_hshlwapi=NULL;
  88 static HANDLE (WINAPI *pSHAllocShared)(LPCVOID,DWORD,DWORD);
  89 static LPVOID (WINAPI *pSHLockShared)(HANDLE,DWORD);
  90 static BOOL   (WINAPI *pSHUnlockShared)(LPVOID);
  91 static BOOL   (WINAPI *pSHFreeShared)(HANDLE,DWORD);
  92
  93
  94 /*************************************************************************
  95  * ParseFieldA                                  [internal]
  96  *
  97  * copies a field from a ',' delimited string
  98  *
  99  * first field is nField = 1
 100  */
 101 DWORD WINAPI ParseFieldA(
 102         LPCSTR src,
 103         DWORD nField,
 104         LPSTR dst,
 105         DWORD len)
 106 {
 107         WARN("(%s,0x%08lx,%p,%ld) semi-stub.\n",debugstr_a(src),nField,dst,len);
 108
 109         if (!src || !src[0] || !dst || !len)
 110           return 0;
 111
 112         /* skip n fields delimited by ',' */
 113         while (nField > 1)
 114         {
 115           if (*src=='\0') return FALSE;
 116           if (*(src++)==',') nField--;
 117         }
 118
 119         /* copy part till the next ',' to dst */
 120         while ( *src!='\0' && *src!=',' && (len--)>0 ) *(dst++)=*(src++);
 121
 122         /* finalize the string */
 123         *dst=0x0;
 124
 125         return TRUE;
 126 }
 127
 128 /*************************************************************************
 129  * ParseFieldW                  [internal]
 130  *
 131  * copies a field from a ',' delimited string
 132  *
 133  * first field is nField = 1
 134  */
 135 DWORD WINAPI ParseFieldW(LPCWSTR src, DWORD nField, LPWSTR dst, DWORD len)
 136 {
 137         WARN("(%s,0x%08lx,%p,%ld) semi-stub.\n", debugstr_w(src), nField, dst, len);
 138
 139         if (!src || !src[0] || !dst || !len)
 140           return 0;
 141
 142         /* skip n fields delimited by ',' */
 143         while (nField > 1)
 144         {
 145           if (*src == 0x0) return FALSE;
 146           if (*src++ == ',') nField--;
 147         }
 148
 149         /* copy part till the next ',' to dst */
 150         while ( *src != 0x0 && *src != ',' && (len--)>0 ) *(dst++) = *(src++);
 151
 152         /* finalize the string */
 153         *dst = 0x0;
 154
 155         return TRUE;
 156 }
 157
 158 /*************************************************************************
 159  * ParseField                   [SHELL32.58]
 160  */
 161 DWORD WINAPI ParseFieldAW(LPCVOID src, DWORD nField, LPVOID dst, DWORD len)
 162 {
 163         if (SHELL_OsIsUnicode())
 164           return ParseFieldW(src, nField, dst, len);
 165         return ParseFieldA(src, nField, dst, len);
 166 }
 167
 168 /*************************************************************************
 169  * GetFileNameFromBrowse                        [SHELL32.63]
 170  *
 171  */
 172 BOOL WINAPI GetFileNameFromBrowse(
 173         HWND hwndOwner,
 174         LPSTR lpstrFile,
 175         DWORD nMaxFile,
 176         LPCSTR lpstrInitialDir,
 177         LPCSTR lpstrDefExt,
 178         LPCSTR lpstrFilter,
 179         LPCSTR lpstrTitle)
 180 {
 181     HMODULE hmodule;
 182     FARPROC pGetOpenFileNameA;
 183     OPENFILENAMEA ofn;
 184     BOOL ret;
 185
 186     TRACE("%p, %s, %ld, %s, %s, %s, %s)\n",
 187           hwndOwner, lpstrFile, nMaxFile, lpstrInitialDir, lpstrDefExt,
 188           lpstrFilter, lpstrTitle);
 189
 190     hmodule = LoadLibraryA("comdlg32.dll");
 191     if(!hmodule) return FALSE;
 192     pGetOpenFileNameA = GetProcAddress(hmodule, "GetOpenFileNameA");
 193     if(!pGetOpenFileNameA)
 194     {
 195         FreeLibrary(hmodule);
 196         return FALSE;
 197     }
 198
 199     memset(&ofn, 0, sizeof(ofn));
 200
 201     ofn.lStructSize = sizeof(ofn);
 202     ofn.hwndOwner = hwndOwner;
 203     ofn.lpstrFilter = lpstrFilter;
 204     ofn.lpstrFile = lpstrFile;
 205     ofn.nMaxFile = nMaxFile;
 206     ofn.lpstrInitialDir = lpstrInitialDir;
 207     ofn.lpstrTitle = lpstrTitle;
 208     ofn.lpstrDefExt = lpstrDefExt;
 209     ofn.Flags = OFN_EXPLORER | OFN_HIDEREADONLY | OFN_FILEMUSTEXIST;
 210     ret = pGetOpenFileNameA(&ofn);
 211
 212     FreeLibrary(hmodule);
 213     return ret;
 214 }
 215
 216 /*************************************************************************
 217  * SHGetSetSettings                             [SHELL32.68]
 218  */
 219 VOID WINAPI SHGetSetSettings(LPSHELLSTATE lpss, DWORD dwMask, BOOL bSet)
 220 {
 221   if(bSet)
 222   {
 223     FIXME("%p 0x%08lx TRUE\n", lpss, dwMask);
 224   }
 225   else
 226   {
 227     SHGetSettings((LPSHELLFLAGSTATE)lpss,dwMask);
 228   }
 229 }
 230
 231 /*************************************************************************
 232  * SHGetSettings                                [SHELL32.@]
 233  *
 234  * NOTES
 235  *  the registry path are for win98 (tested)
 236  *  and possibly are the same in nt40
 237  *
 238  */
 239 VOID WINAPI SHGetSettings(LPSHELLFLAGSTATE lpsfs, DWORD dwMask)
 240 {
 241         HKEY    hKey;
 242         DWORD   dwData;
 243         DWORD   dwDataSize = sizeof (DWORD);
 244
 245         TRACE("(%p 0x%08lx)\n",lpsfs,dwMask);
 246
 247         if (RegCreateKeyExA(HKEY_CURRENT_USER, "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Advanced",
 248                                  0, 0, 0, KEY_ALL_ACCESS, 0, &hKey, 0))
 249           return;
 250
 251         if ( (SSF_SHOWEXTENSIONS & dwMask) && !RegQueryValueExA(hKey, "HideFileExt", 0, 0, (LPBYTE)&dwData, &dwDataSize))
 252           lpsfs->fShowExtensions  = ((dwData == 0) ?  0 : 1);
 253
 254         if ( (SSF_SHOWINFOTIP & dwMask) && !RegQueryValueExA(hKey, "ShowInfoTip", 0, 0, (LPBYTE)&dwData, &dwDataSize))
 255           lpsfs->fShowInfoTip  = ((dwData == 0) ?  0 : 1);
 256
 257         if ( (SSF_DONTPRETTYPATH & dwMask) && !RegQueryValueExA(hKey, "DontPrettyPath", 0, 0, (LPBYTE)&dwData, &dwDataSize))
 258           lpsfs->fDontPrettyPath  = ((dwData == 0) ?  0 : 1);
 259
 260         if ( (SSF_HIDEICONS & dwMask) && !RegQueryValueExA(hKey, "HideIcons", 0, 0, (LPBYTE)&dwData, &dwDataSize))
 261           lpsfs->fHideIcons  = ((dwData == 0) ?  0 : 1);
 262
 263         if ( (SSF_MAPNETDRVBUTTON & dwMask) && !RegQueryValueExA(hKey, "MapNetDrvBtn", 0, 0, (LPBYTE)&dwData, &dwDataSize))
 264           lpsfs->fMapNetDrvBtn  = ((dwData == 0) ?  0 : 1);
 265
 266         if ( (SSF_SHOWATTRIBCOL & dwMask) && !RegQueryValueExA(hKey, "ShowAttribCol", 0, 0, (LPBYTE)&dwData, &dwDataSize))
 267           lpsfs->fShowAttribCol  = ((dwData == 0) ?  0 : 1);
 268
 269         if (((SSF_SHOWALLOBJECTS | SSF_SHOWSYSFILES) & dwMask) && !RegQueryValueExA(hKey, "Hidden", 0, 0, (LPBYTE)&dwData, &dwDataSize))
 270         { if (dwData == 0)
 271           { if (SSF_SHOWALLOBJECTS & dwMask)    lpsfs->fShowAllObjects  = 0;
 272             if (SSF_SHOWSYSFILES & dwMask)      lpsfs->fShowSysFiles  = 0;
 273           }
 274           else if (dwData == 1)
 275           { if (SSF_SHOWALLOBJECTS & dwMask)    lpsfs->fShowAllObjects  = 1;
 276             if (SSF_SHOWSYSFILES & dwMask)      lpsfs->fShowSysFiles  = 0;
 277           }
 278           else if (dwData == 2)
 279           { if (SSF_SHOWALLOBJECTS & dwMask)    lpsfs->fShowAllObjects  = 0;
 280             if (SSF_SHOWSYSFILES & dwMask)      lpsfs->fShowSysFiles  = 1;
 281           }
 282         }
 283         RegCloseKey (hKey);
 284
 285         TRACE("-- 0x%04x\n", *(WORD*)lpsfs);
 286 }
 287
 288 /*************************************************************************
 289  * SHShellFolderView_Message                    [SHELL32.73]
 290  *
 291  * Send a message to an explorer cabinet window.
 292  *
 293  * PARAMS
 294  *  hwndCabinet [I] The window containing the shellview to communicate with
 295  *  dwMessage   [I] The SFVM message to send
 296  *  dwParam     [I] Message parameter
 297  *
 298  * RETURNS
 299  *  fixme.
 300  *
 301  * NOTES
 302  *  Message SFVM_REARRANGE = 1
 303  *
 304  *    This message gets sent when a column gets clicked to instruct the
 305  *    shell view to re-sort the item list. dwParam identifies the column
 306  *    that was clicked.
 307  */
 308 LRESULT WINAPI SHShellFolderView_Message(
 309         HWND hwndCabinet,
 310         UINT uMessage,
 311         LPARAM lParam)
 312 {
 313         FIXME("%p %08x %08lx stub\n",hwndCabinet, uMessage, lParam);
 314         return 0;
 315 }
 316
 317 /*************************************************************************
 318  * RegisterShellHook                            [SHELL32.181]
 319  *
 320  * Register a shell hook.
 321  *
 322  * PARAMS
 323  *      hwnd   [I]  Window handle
 324  *      dwType [I]  Type of hook.
 325  *
 326  * NOTES
 327  *     Exported by ordinal
 328  */
 329 BOOL WINAPI RegisterShellHook(
 330         HWND hWnd,
 331         DWORD dwType)
 332 {
 333         FIXME("(%p,0x%08lx):stub.\n",hWnd, dwType);
 334         return TRUE;
 335 }
 336
 337 /*************************************************************************
 338  * ShellMessageBoxW                             [SHELL32.182]
 339  *
 340  * See ShellMessageBoxA.
 341  */
 342 int WINAPIV ShellMessageBoxW(
 343         HINSTANCE hInstance,
 344         HWND hWnd,
 345         LPCWSTR lpText,
 346         LPCWSTR lpCaption,
 347         UINT uType,
 348         ...)
 349 {
 350         WCHAR   szText[100],szTitle[100];
 351         LPCWSTR pszText = szText, pszTitle = szTitle, pszTemp;
 352         va_list args;
 353         int     ret;
 354
 355         va_start(args, uType);
 356         /* wvsprintfA(buf,fmt, args); */
 357
 358         TRACE("(%08lx,%08lx,%p,%p,%08x)\n",
 359         (DWORD)hInstance,(DWORD)hWnd,lpText,lpCaption,uType);
 360
 361         if (!HIWORD(lpCaption))
 362           LoadStringW(hInstance, (DWORD)lpCaption, szTitle, sizeof(szTitle)/sizeof(szTitle[0]));
 363         else
 364           pszTitle = lpCaption;
 365
 366         if (!HIWORD(lpText))
 367           LoadStringW(hInstance, (DWORD)lpText, szText, sizeof(szText)/sizeof(szText[0]));
 368         else
 369           pszText = lpText;
 370
 371         FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
 372                        pszText, 0, 0, (LPWSTR)&pszTemp, 0, &args);
 373
 374         va_end(args);
 375
 376         ret = MessageBoxW(hWnd,pszTemp,pszTitle,uType);
 377         LocalFree((HLOCAL)pszTemp);
 378         return ret;
 379 }
 380
 381 /*************************************************************************
 382  * ShellMessageBoxA                             [SHELL32.183]
 383  *
 384  * Format and output an error message.
 385  *
 386  * PARAMS
 387  *  hInstance [I] Instance handle of message creator
 388  *  hWnd      [I] Window handle of message creator
 389  *  lpText    [I] Resource Id of title or LPSTR
 390  *  lpCaption [I] Resource Id of title or LPSTR
 391  *  uType     [I] Type of error message
 392  *
 393  * RETURNS
 394  *  A return value from MessageBoxA().
 395  *
 396  * NOTES
 397  *     Exported by ordinal
 398  */
 399 int WINAPIV ShellMessageBoxA(
 400         HINSTANCE hInstance,
 401         HWND hWnd,
 402         LPCSTR lpText,
 403         LPCSTR lpCaption,
 404         UINT uType,
 405         ...)
 406 {
 407         char    szText[100],szTitle[100];
 408         LPCSTR  pszText = szText, pszTitle = szTitle, pszTemp;
 409         va_list args;
 410         int     ret;
 411
 412         va_start(args, uType);
 413         /* wvsprintfA(buf,fmt, args); */
 414
 415         TRACE("(%08lx,%08lx,%p,%p,%08x)\n",
 416         (DWORD)hInstance,(DWORD)hWnd,lpText,lpCaption,uType);
 417
 418         if (!HIWORD(lpCaption))
 419           LoadStringA(hInstance, (DWORD)lpCaption, szTitle, sizeof(szTitle));
 420         else
 421           pszTitle = lpCaption;
 422
 423         if (!HIWORD(lpText))
 424           LoadStringA(hInstance, (DWORD)lpText, szText, sizeof(szText));
 425         else
 426           pszText = lpText;
 427
 428         FormatMessageA(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
 429                        pszText, 0, 0, (LPSTR)&pszTemp, 0, &args);
 430
 431         va_end(args);
 432
 433         ret = MessageBoxA(hWnd,pszTemp,pszTitle,uType);
 434         LocalFree((HLOCAL)pszTemp);
 435         return ret;
 436 }
 437
 438 /*************************************************************************
 439  * SHRegisterDragDrop                           [SHELL32.86]
 440  *
 441  * NOTES
 442  *     exported by ordinal
 443  */
 444 HRESULT WINAPI SHRegisterDragDrop(
 445         HWND hWnd,
 446         LPDROPTARGET pDropTarget)
 447 {
 448         FIXME("(%p,%p):stub.\n", hWnd, pDropTarget);
 449         return RegisterDragDrop(hWnd, pDropTarget);
 450 }
 451
 452 /*************************************************************************
 453  * SHRevokeDragDrop                             [SHELL32.87]
 454  *
 455  * NOTES
 456  *     exported by ordinal
 457  */
 458 HRESULT WINAPI SHRevokeDragDrop(HWND hWnd)
 459 {
 460     FIXME("(%p):stub.\n",hWnd);
 461     return RevokeDragDrop(hWnd);
 462 }
 463
 464 /*************************************************************************
 465  * SHDoDragDrop                                 [SHELL32.88]
 466  *
 467  * NOTES
 468  *     exported by ordinal
 469  */
 470 HRESULT WINAPI SHDoDragDrop(
 471         HWND hWnd,
 472         LPDATAOBJECT lpDataObject,
 473         LPDROPSOURCE lpDropSource,
 474         DWORD dwOKEffect,
 475         LPDWORD pdwEffect)
 476 {
 477     FIXME("(%p %p %p 0x%08lx %p):stub.\n",
 478     hWnd, lpDataObject, lpDropSource, dwOKEffect, pdwEffect);
 479         return DoDragDrop(lpDataObject, lpDropSource, dwOKEffect, pdwEffect);
 480 }
 481
 482 /*************************************************************************
 483  * ArrangeWindows                               [SHELL32.184]
 484  *
 485  */
 486 WORD WINAPI ArrangeWindows(
 487         HWND hwndParent,
 488         DWORD dwReserved,
 489         LPCRECT lpRect,
 490         WORD cKids,
 491         CONST HWND * lpKids)
 492 {
 493     FIXME("(%p 0x%08lx %p 0x%04x %p):stub.\n",
 494            hwndParent, dwReserved, lpRect, cKids, lpKids);
 495     return 0;
 496 }
 497
 498 /*************************************************************************
 499  * SignalFileOpen                               [SHELL32.103]
 500  *
 501  * NOTES
 502  *     exported by ordinal
 503  */
 504 DWORD WINAPI
 505 SignalFileOpen (DWORD dwParam1)
 506 {
 507     FIXME("(0x%08lx):stub.\n", dwParam1);
 508
 509     return 0;
 510 }
 511
 512 /*************************************************************************
 513  * SHADD_get_policy - helper function for SHAddToRecentDocs
 514  *
 515  * PARAMETERS
 516  *   policy    [IN]  policy name (null termed string) to find
 517  *   type      [OUT] ptr to DWORD to receive type
 518  *   buffer    [OUT] ptr to area to hold data retrieved
 519  *   len       [IN/OUT] ptr to DWORD holding size of buffer and getting
 520  *                      length filled
 521  *
 522  * RETURNS
 523  *   result of the SHQueryValueEx call
 524  */
 525 static INT SHADD_get_policy(LPSTR policy, LPDWORD type, LPVOID buffer, LPDWORD len)
 526 {
 527     HKEY Policy_basekey;
 528     INT ret;
 529
 530     /* Get the key for the policies location in the registry
 531      */
 532     if (RegOpenKeyExA(HKEY_LOCAL_MACHINE,
 533                       "Software\\Microsoft\\Windows\\CurrentVersion\\Policies\\Explorer",
 534                       0, KEY_READ, &Policy_basekey)) {
 535
 536         if (RegOpenKeyExA(HKEY_CURRENT_USER,
 537                           "Software\\Microsoft\\Windows\\CurrentVersion\\Policies\\Explorer",
 538                           0, KEY_READ, &Policy_basekey)) {
 539             TRACE("No Explorer Policies location exists. Policy wanted=%s\n",
 540                   policy);
 541             *len = 0;
 542             return ERROR_FILE_NOT_FOUND;
 543         }
 544     }
 545
 546     /* Retrieve the data if it exists
 547      */
 548     ret = SHQueryValueExA(Policy_basekey, policy, 0, type, buffer, len);
 549     RegCloseKey(Policy_basekey);
 550     return ret;
 551 }
 552
 553
 554 /*************************************************************************
 555  * SHADD_compare_mru - helper function for SHAddToRecentDocs
 556  *
 557  * PARAMETERS
 558  *   data1     [IN] data being looked for
 559  *   data2     [IN] data in MRU
 560  *   cbdata    [IN] length from FindMRUData call (not used)
 561  *
 562  * RETURNS
 563  *   position within MRU list that data was added.
 564  */
 565 static INT CALLBACK SHADD_compare_mru(LPCVOID data1, LPCVOID data2, DWORD cbData)
 566 {
 567     return lstrcmpiA(data1, data2);
 568 }
 569
 570 /*************************************************************************
 571  * SHADD_create_add_mru_data - helper function for SHAddToRecentDocs
 572  *
 573  * PARAMETERS
 574  *   mruhandle    [IN] handle for created MRU list
 575  *   doc_name     [IN] null termed pure doc name
 576  *   new_lnk_name [IN] null termed path and file name for .lnk file
 577  *   buffer       [IN/OUT] 2048 byte area to construct MRU data
 578  *   len          [OUT] ptr to int to receive space used in buffer
 579  *
 580  * RETURNS
 581  *   position within MRU list that data was added.
 582  */
 583 static INT SHADD_create_add_mru_data(HANDLE mruhandle, LPSTR doc_name, LPSTR new_lnk_name,
 584                                      LPSTR buffer, INT *len)
 585 {
 586     LPSTR ptr;
 587     INT wlen;
 588
 589     /*FIXME: Document:
 590      *  RecentDocs MRU data structure seems to be:
 591      *    +0h   document file name w/ terminating 0h
 592      *    +nh   short int w/ size of remaining
 593      *    +n+2h 02h 30h, or 01h 30h, or 00h 30h  -  unknown
 594      *    +n+4h 10 bytes zeros  -   unknown
 595      *    +n+eh shortcut file name w/ terminating 0h
 596      *    +n+e+nh 3 zero bytes  -  unknown
 597      */
 598
 599     /* Create the MRU data structure for "RecentDocs"
 600          */
 601     ptr = buffer;
 602     lstrcpyA(ptr, doc_name);
 603     ptr += (lstrlenA(buffer) + 1);
 604     wlen= lstrlenA(new_lnk_name) + 1 + 12;
 605     *((short int*)ptr) = wlen;
 606     ptr += 2;   /* step past the length */
 607     *(ptr++) = 0x30;  /* unknown reason */
 608     *(ptr++) = 0;     /* unknown, but can be 0x00, 0x01, 0x02 */
 609     memset(ptr, 0, 10);
 610     ptr += 10;
 611     lstrcpyA(ptr, new_lnk_name);
 612     ptr += (lstrlenA(new_lnk_name) + 1);
 613     memset(ptr, 0, 3);
 614     ptr += 3;
 615     *len = ptr - buffer;
 616
 617     /* Add the new entry into the MRU list
 618      */
 619     return AddMRUData(mruhandle, (LPCVOID)buffer, *len);
 620 }
 621
 622 /*************************************************************************
 623  * SHAddToRecentDocs                            [SHELL32.@]
 624  *
 625  * PARAMETERS
 626  *   uFlags  [IN] SHARD_PATH or SHARD_PIDL
 627  *   pv      [IN] string or pidl, NULL clears the list
 628  *
 629  * NOTES
 630  *     exported by name
 631  */
 632 void WINAPI SHAddToRecentDocs (UINT uFlags,LPCVOID pv)
 633 {
 634 /* If list is a string list lpfnCompare has the following prototype
 635  * int CALLBACK MRUCompareString(LPCSTR s1, LPCSTR s2)
 636  * for binary lists the prototype is
 637  * int CALLBACK MRUCompareBinary(LPCVOID data1, LPCVOID data2, DWORD cbData)
 638  * where cbData is the no. of bytes to compare.
 639  * Need to check what return value means identical - 0?
 640  */
 641
 642
 643     UINT olderrormode;
 644     HKEY HCUbasekey;
 645     CHAR doc_name[MAX_PATH];
 646     CHAR link_dir[MAX_PATH];
 647     CHAR new_lnk_filepath[MAX_PATH];
 648     CHAR new_lnk_name[MAX_PATH];
 649     IMalloc *ppM;
 650     LPITEMIDLIST pidl;
 651     HWND hwnd = 0;       /* FIXME:  get real window handle */
 652     INT ret;
 653     DWORD data[64], datalen, type;
 654
 655     /*FIXME: Document:
 656      *  RecentDocs MRU data structure seems to be:
 657      *    +0h   document file name w/ terminating 0h
 658      *    +nh   short int w/ size of remaining
 659      *    +n+2h 02h 30h, or 01h 30h, or 00h 30h  -  unknown
 660      *    +n+4h 10 bytes zeros  -   unknown
 661      *    +n+eh shortcut file name w/ terminating 0h
 662      *    +n+e+nh 3 zero bytes  -  unknown
 663      */
 664
 665     /* See if we need to do anything.
 666      */
 667     datalen = 64;
 668     ret=SHADD_get_policy( "NoRecentDocsHistory", &type, &data, &datalen);
 669     if ((ret > 0) && (ret != ERROR_FILE_NOT_FOUND)) {
 670         ERR("Error %d getting policy \"NoRecentDocsHistory\"\n", ret);
 671         return;
 672     }
 673     if (ret == ERROR_SUCCESS) {
 674         if (!( (type == REG_DWORD) ||
 675                ((type == REG_BINARY) && (datalen == 4)) )) {
 676             ERR("Error policy data for \"NoRecentDocsHistory\" not formatted correctly, type=%ld, len=%ld\n",
 677                 type, datalen);
 678             return;
 679         }
 680
 681         TRACE("policy value for NoRecentDocsHistory = %08lx\n", data[0]);
 682         /* now test the actual policy value */
 683         if ( data[0] != 0)
 684             return;
 685     }
 686
 687     /* Open key to where the necessary info is
 688      */
 689     /* FIXME: This should be done during DLL PROCESS_ATTACH (or THREAD_ATTACH)
 690      *        and the close should be done during the _DETACH. The resulting
 691      *        key is stored in the DLL global data.
 692      */
 693     if (RegCreateKeyExA(HKEY_CURRENT_USER,
 694                         "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer",
 695                         0, 0, 0, KEY_READ, 0, &HCUbasekey, 0)) {
 696         ERR("Failed to create 'Software\\Microsoft\\Windows\\CurrentVersion\\Explorer'\n");
 697         return;
 698     }
 699
 700     /* Get path to user's "Recent" directory
 701      */
 702     if(SUCCEEDED(SHGetMalloc(&ppM))) {
 703         if (SUCCEEDED(SHGetSpecialFolderLocation(hwnd, CSIDL_RECENT,
 704                                                  &pidl))) {
 705             SHGetPathFromIDListA(pidl, link_dir);
 706             IMalloc_Free(ppM, pidl);
 707         }
 708         else {
 709             /* serious issues */
 710             link_dir[0] = 0;
 711             ERR("serious issues 1\n");
 712         }
 713         IMalloc_Release(ppM);
 714     }
 715     else {
 716         /* serious issues */
 717         link_dir[0] = 0;
 718         ERR("serious issues 2\n");
 719     }
 720     TRACE("Users Recent dir %s\n", link_dir);
 721
 722     /* If no input, then go clear the lists */
 723     if (!pv) {
 724         /* clear user's Recent dir
 725          */
 726
 727         /* FIXME: delete all files in "link_dir"
 728          *
 729          * while( more files ) {
 730          *    lstrcpyA(old_lnk_name, link_dir);
 731          *    PathAppendA(old_lnk_name, filenam);
 732          *    DeleteFileA(old_lnk_name);
 733          * }
 734          */
 735         FIXME("should delete all files in %s\\ \n", link_dir);
 736
 737         /* clear MRU list
 738          */
 739         /* MS Bug ?? v4.72.3612.1700 of shell32 does the delete against
 740          *  HKEY_LOCAL_MACHINE version of ...CurrentVersion\Explorer
 741          *  and naturally it fails w/ rc=2. It should do it against
 742          *  HKEY_CURRENT_USER which is where it is stored, and where
 743          *  the MRU routines expect it!!!!
 744          */
 745         RegDeleteKeyA(HCUbasekey, "RecentDocs");
 746         RegCloseKey(HCUbasekey);
 747         return;
 748     }
 749
 750     /* Have data to add, the jobs to be done:
 751      *   1. Add document to MRU list in registry "HKCU\Software\
 752      *      Microsoft\Windows\CurrentVersion\Explorer\RecentDocs".
 753      *   2. Add shortcut to document in the user's Recent directory
 754      *      (CSIDL_RECENT).
 755      *   3. Add shortcut to Start menu's Documents submenu.
 756      */
 757
 758     /* Get the pure document name from the input
 759      */
 760     if (uFlags & SHARD_PIDL) {
 761         SHGetPathFromIDListA((LPCITEMIDLIST) pv, doc_name);
 762     }
 763     else {
 764         lstrcpyA(doc_name, (LPCSTR) pv);
 765     }
 766     TRACE("full document name %s\n", doc_name);
 767     PathStripPathA(doc_name);
 768     TRACE("stripped document name %s\n", doc_name);
 769
 770
 771     /* ***  JOB 1: Update registry for ...\Explorer\RecentDocs list  *** */
 772
 773     {  /* on input needs:
 774         *      doc_name    -  pure file-spec, no path
 775         *      link_dir    -  path to the user's Recent directory
 776         *      HCUbasekey  -  key of ...Windows\CurrentVersion\Explorer" node
 777         * creates:
 778         *      new_lnk_name-  pure file-spec, no path for new .lnk file
 779         *      new_lnk_filepath
 780         *                  -  path and file name of new .lnk file
 781         */
 782         CREATEMRULISTA mymru;
 783         HANDLE mruhandle;
 784         INT len, pos, bufused, err;
 785         INT i;
 786         DWORD attr;
 787         CHAR buffer[2048];
 788         CHAR *ptr;
 789         CHAR old_lnk_name[MAX_PATH];
 790         short int slen;
 791
 792         mymru.cbSize = sizeof(CREATEMRULISTA);
 793         mymru.nMaxItems = 15;
 794         mymru.dwFlags = MRUF_BINARY_LIST | MRUF_DELAYED_SAVE;
 795         mymru.hKey = HCUbasekey;
 796         mymru.lpszSubKey = "RecentDocs";
 797         mymru.lpfnCompare = &SHADD_compare_mru;
 798         mruhandle = CreateMRUListA(&mymru);
 799         if (!mruhandle) {
 800             /* MRU failed */
 801             ERR("MRU processing failed, handle zero\n");
 802             RegCloseKey(HCUbasekey);
 803             return;
 804         }
 805         len = lstrlenA(doc_name);
 806         pos = FindMRUData(mruhandle, doc_name, len, 0);
 807
 808         /* Now get the MRU entry that will be replaced
 809          * and delete the .lnk file for it
 810          */
 811         if ((bufused = EnumMRUListA(mruhandle, (pos == -1) ? 14 : pos,
 812                                     buffer, 2048)) != -1) {
 813             ptr = buffer;
 814             ptr += (lstrlenA(buffer) + 1);
 815             slen = *((short int*)ptr);
 816             ptr += 2;  /* skip the length area */
 817             if (bufused >= slen + (ptr-buffer)) {
 818                 /* buffer size looks good */
 819                 ptr += 12; /* get to string */
 820                 len = bufused - (ptr-buffer);  /* get length of buf remaining */
 821                 if ((lstrlenA(ptr) > 0) && (lstrlenA(ptr) <= len-1)) {
 822                     /* appears to be good string */
 823                     lstrcpyA(old_lnk_name, link_dir);
 824                     PathAppendA(old_lnk_name, ptr);
 825                     if (!DeleteFileA(old_lnk_name)) {
 826                         if ((attr = GetFileAttributesA(old_lnk_name)) == INVALID_FILE_ATTRIBUTES) {
 827                             if ((err = GetLastError()) != ERROR_FILE_NOT_FOUND) {
 828                                 ERR("Delete for %s failed, err=%d, attr=%08lx\n",
 829                                     old_lnk_name, err, attr);
 830                             }
 831                             else {
 832                                 TRACE("old .lnk file %s did not exist\n",
 833                                       old_lnk_name);
 834                             }
 835                         }
 836                         else {
 837                             ERR("Delete for %s failed, attr=%08lx\n",
 838                                 old_lnk_name, attr);
 839                         }
 840                     }
 841                     else {
 842                         TRACE("deleted old .lnk file %s\n", old_lnk_name);
 843                     }
 844                 }
 845             }
 846         }
 847
 848         /* Create usable .lnk file name for the "Recent" directory
 849          */
 850         wsprintfA(new_lnk_name, "%s.lnk", doc_name);
 851         lstrcpyA(new_lnk_filepath, link_dir);
 852         PathAppendA(new_lnk_filepath, new_lnk_name);
 853         i = 1;
 854         olderrormode = SetErrorMode(SEM_FAILCRITICALERRORS);
 855         while (GetFileAttributesA(new_lnk_filepath) != INVALID_FILE_ATTRIBUTES) {
 856             i++;
 857             wsprintfA(new_lnk_name, "%s (%u).lnk", doc_name, i);
 858             lstrcpyA(new_lnk_filepath, link_dir);
 859             PathAppendA(new_lnk_filepath, new_lnk_name);
 860         }
 861         SetErrorMode(olderrormode);
 862         TRACE("new shortcut will be %s\n", new_lnk_filepath);
 863
 864         /* Now add the new MRU entry and data
 865          */
 866         pos = SHADD_create_add_mru_data(mruhandle, doc_name, new_lnk_name,
 867                                         buffer, &len);
 868         FreeMRUList(mruhandle);
 869         TRACE("Updated MRU list, new doc is position %d\n", pos);
 870     }
 871
 872     /* ***  JOB 2: Create shortcut in user's "Recent" directory  *** */
 873
 874     {  /* on input needs:
 875         *      doc_name    -  pure file-spec, no path
 876         *      new_lnk_filepath
 877         *                  -  path and file name of new .lnk file
 878         *      uFlags[in]  -  flags on call to SHAddToRecentDocs
 879         *      pv[in]      -  document path/pidl on call to SHAddToRecentDocs
 880         */
 881         IShellLinkA *psl = NULL;
 882         IPersistFile *pPf = NULL;
 883         HRESULT hres;
 884         CHAR desc[MAX_PATH];
 885         WCHAR widelink[MAX_PATH];
 886
 887         CoInitialize(0);
 888
 889         hres = CoCreateInstance( &CLSID_ShellLink,
 890                                  NULL,
 891                                  CLSCTX_INPROC_SERVER,
 892                                  &IID_IShellLinkA,
 893                                  (LPVOID )&psl);
 894         if(SUCCEEDED(hres)) {
 895
 896             hres = IShellLinkA_QueryInterface(psl, &IID_IPersistFile,
 897                                              (LPVOID *)&pPf);
 898             if(FAILED(hres)) {
 899                 /* bombed */
 900                 ERR("failed QueryInterface for IPersistFile %08lx\n", hres);
 901                 goto fail;
 902             }
 903
 904             /* Set the document path or pidl */
 905             if (uFlags & SHARD_PIDL) {
 906                 hres = IShellLinkA_SetIDList(psl, (LPCITEMIDLIST) pv);
 907             } else {
 908                 hres = IShellLinkA_SetPath(psl, (LPCSTR) pv);
 909             }
 910             if(FAILED(hres)) {
 911                 /* bombed */
 912                 ERR("failed Set{IDList|Path} %08lx\n", hres);
 913                 goto fail;
 914             }
 915
 916             lstrcpyA(desc, "Shortcut to ");
 917             lstrcatA(desc, doc_name);
 918             hres = IShellLinkA_SetDescription(psl, desc);
 919             if(FAILED(hres)) {
 920                 /* bombed */
 921                 ERR("failed SetDescription %08lx\n", hres);
 922                 goto fail;
 923             }
 924
 925             MultiByteToWideChar(CP_ACP, 0, new_lnk_filepath, -1,
 926                                 widelink, MAX_PATH);
 927             /* create the short cut */
 928             hres = IPersistFile_Save(pPf, widelink, TRUE);
 929             if(FAILED(hres)) {
 930                 /* bombed */
 931                 ERR("failed IPersistFile::Save %08lx\n", hres);
 932                 IPersistFile_Release(pPf);
 933                 IShellLinkA_Release(psl);
 934                 goto fail;
 935             }
 936             hres = IPersistFile_SaveCompleted(pPf, widelink);
 937             IPersistFile_Release(pPf);
 938             IShellLinkA_Release(psl);
 939             TRACE("shortcut %s has been created, result=%08lx\n",
 940                   new_lnk_filepath, hres);
 941         }
 942         else {
 943             ERR("CoCreateInstance failed, hres=%08lx\n", hres);
 944         }
 945     }
 946
 947  fail:
 948     CoUninitialize();
 949
 950     /* all done */
 951     RegCloseKey(HCUbasekey);
 952     return;
 953 }
 954
 955 /*************************************************************************
 956  * SHCreateShellFolderViewEx                    [SHELL32.174]
 957  *
 958  * NOTES
 959  *  see IShellFolder::CreateViewObject
 960  */
 961 HRESULT WINAPI SHCreateShellFolderViewEx(
 962         LPCSFV psvcbi,    /* [in] shelltemplate struct */
 963         IShellView **ppv) /* [out] IShellView pointer */
 964 {
 965         IShellView * psf;
 966         HRESULT hRes;
 967
 968         TRACE("sf=%p pidl=%p cb=%p mode=0x%08x parm=%p\n",
 969           psvcbi->pshf, psvcbi->pidl, psvcbi->pfnCallback,
 970           psvcbi->fvm, psvcbi->psvOuter);
 971
 972         psf = IShellView_Constructor(psvcbi->pshf);
 973
 974         if (!psf)
 975           return E_OUTOFMEMORY;
 976
 977         IShellView_AddRef(psf);
 978         hRes = IShellView_QueryInterface(psf, &IID_IShellView, (LPVOID *)ppv);
 979         IShellView_Release(psf);
 980
 981         return hRes;
 982 }
 983 /*************************************************************************
 984  *  SHWinHelp                                   [SHELL32.127]
 985  *
 986  */
 987 HRESULT WINAPI SHWinHelp (DWORD v, DWORD w, DWORD x, DWORD z)
 988 {       FIXME("0x%08lx 0x%08lx 0x%08lx 0x%08lx stub\n",v,w,x,z);
 989         return 0;
 990 }
 991 /*************************************************************************
 992  *  SHRunControlPanel [SHELL32.161]
 993  *
 994  */
 995 HRESULT WINAPI SHRunControlPanel (DWORD x, DWORD z)
 996 {       FIXME("0x%08lx 0x%08lx stub\n",x,z);
 997         return 0;
 998 }
 999
1000 static LPUNKNOWN SHELL32_IExplorerInterface=0;
1001 /*************************************************************************
1002  * SHSetInstanceExplorer                        [SHELL32.176]
1003  *
1004  * NOTES
1005  *  Sets the interface
1006  */
1007 HRESULT WINAPI SHSetInstanceExplorer (LPUNKNOWN lpUnknown)
1008 {       TRACE("%p\n", lpUnknown);
1009         SHELL32_IExplorerInterface = lpUnknown;
1010         return (HRESULT) lpUnknown;
1011 }
1012 /*************************************************************************
1013  * SHGetInstanceExplorer                        [SHELL32.@]
1014  *
1015  * NOTES
1016  *  gets the interface pointer of the explorer and a reference
1017  */
1018 HRESULT WINAPI SHGetInstanceExplorer (LPUNKNOWN * lpUnknown)
1019 {       TRACE("%p\n", lpUnknown);
1020
1021         *lpUnknown = SHELL32_IExplorerInterface;
1022
1023         if (!SHELL32_IExplorerInterface)
1024           return E_FAIL;
1025
1026         IUnknown_AddRef(SHELL32_IExplorerInterface);
1027         return NOERROR;
1028 }
1029 /*************************************************************************
1030  * SHFreeUnusedLibraries                        [SHELL32.123]
1031  *
1032  * NOTES
1033  *  exported by name
1034  */
1035 void WINAPI SHFreeUnusedLibraries (void)
1036 {
1037         FIXME("stub\n");
1038 }
1039 /*************************************************************************
1040  * DAD_AutoScroll                               [SHELL32.129]
1041  *
1042  */
1043 BOOL WINAPI DAD_AutoScroll(HWND hwnd, AUTO_SCROLL_DATA *samples, LPPOINT pt)
1044 {
1045     FIXME("hwnd = %p %p %p\n",hwnd,samples,pt);
1046     return 0;
1047 }
1048 /*************************************************************************
1049  * DAD_DragEnter                                [SHELL32.130]
1050  *
1051  */
1052 BOOL WINAPI DAD_DragEnter(HWND hwnd)
1053 {
1054     FIXME("hwnd = %p\n",hwnd);
1055     return FALSE;
1056 }
1057 /*************************************************************************
1058  * DAD_DragEnterEx                              [SHELL32.131]
1059  *
1060  */
1061 BOOL WINAPI DAD_DragEnterEx(HWND hwnd, POINT p)
1062 {
1063     FIXME("hwnd = %p (%ld,%ld)\n",hwnd,p.x,p.y);
1064     return FALSE;
1065 }
1066 /*************************************************************************
1067  * DAD_DragMove                         [SHELL32.134]
1068  *
1069  */
1070 BOOL WINAPI DAD_DragMove(POINT p)
1071 {
1072     FIXME("(%ld,%ld)\n",p.x,p.y);
1073     return FALSE;
1074 }
1075 /*************************************************************************
1076  * DAD_DragLeave                                [SHELL32.132]
1077  *
1078  */
1079 BOOL WINAPI DAD_DragLeave(VOID)
1080 {
1081     FIXME("\n");
1082     return FALSE;
1083 }
1084 /*************************************************************************
1085  * DAD_SetDragImage                             [SHELL32.136]
1086  *
1087  * NOTES
1088  *  exported by name
1089  */
1090 BOOL WINAPI DAD_SetDragImage(
1091         HIMAGELIST himlTrack,
1092         LPPOINT lppt)
1093 {
1094         FIXME("%p %p stub\n",himlTrack, lppt);
1095   return 0;
1096 }
1097 /*************************************************************************
1098  * DAD_ShowDragImage                            [SHELL32.137]
1099  *
1100  * NOTES
1101  *  exported by name
1102  */
1103 BOOL WINAPI DAD_ShowDragImage(BOOL bShow)
1104 {
1105         FIXME("0x%08x stub\n",bShow);
1106         return 0;
1107 }
1108
1109 static const WCHAR szwCabLocation[] = {
1110   'S','o','f','t','w','a','r','e','\\',
1111   'M','i','c','r','o','s','o','f','t','\\',
1112   'W','i','n','d','o','w','s','\\',
1113   'C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\',
1114   'E','x','p','l','o','r','e','r','\\',
1115   'C','a','b','i','n','e','t','S','t','a','t','e',0
1116 };
1117
1118 static const WCHAR szwSettings[] = { 'S','e','t','t','i','n','g','s',0 };
1119
1120 /*************************************************************************
1121  * ReadCabinetState                             [SHELL32.651] NT 4.0
1122  *
1123  */
1124 BOOL WINAPI ReadCabinetState(CABINETSTATE *cs, int length)
1125 {
1126         HKEY hkey = 0;
1127         DWORD type, r;
1128
1129         TRACE("%p %d \n",cs,length);
1130
1131         if( (cs == NULL) || (length < (int)sizeof(*cs))  )
1132                 return FALSE;
1133
1134         r = RegOpenKeyW( HKEY_CURRENT_USER, szwCabLocation, &hkey );
1135         if( r == ERROR_SUCCESS )
1136         {
1137                 type = REG_BINARY;
1138                 r = RegQueryValueExW( hkey, szwSettings,
1139                         NULL, &type, (LPBYTE)cs, (LPDWORD)&length );
1140                 RegCloseKey( hkey );
1141
1142         }
1143
1144         /* if we can't read from the registry, create default values */
1145         if ( (r != ERROR_SUCCESS) || (cs->cLength < sizeof(*cs)) ||
1146                 (cs->cLength != length) )
1147         {
1148                 ERR("Initializing shell cabinet settings\n");
1149                 memset(cs, 0, sizeof(*cs));
1150                 cs->cLength          = sizeof(*cs);
1151                 cs->nVersion         = 2;
1152                 cs->fFullPathTitle   = FALSE;
1153                 cs->fSaveLocalView   = TRUE;
1154                 cs->fNotShell        = FALSE;
1155                 cs->fSimpleDefault   = TRUE;
1156                 cs->fDontShowDescBar = FALSE;
1157                 cs->fNewWindowMode   = FALSE;
1158                 cs->fShowCompColor   = FALSE;
1159                 cs->fDontPrettyNames = FALSE;
1160                 cs->fAdminsCreateCommonGroups = TRUE;
1161                 cs->fMenuEnumFilter  = 96;
1162         }
1163
1164         return TRUE;
1165 }
1166
1167 /*************************************************************************
1168  * WriteCabinetState                            [SHELL32.652] NT 4.0
1169  *
1170  */
1171 BOOL WINAPI WriteCabinetState(CABINETSTATE *cs)
1172 {
1173         DWORD r;
1174         HKEY hkey = 0;
1175
1176         TRACE("%p\n",cs);
1177
1178         if( cs == NULL )
1179                 return FALSE;
1180
1181         r = RegCreateKeyExW( HKEY_CURRENT_USER, szwCabLocation, 0,
1182                  NULL, 0, KEY_ALL_ACCESS, NULL, &hkey, NULL);
1183         if( r == ERROR_SUCCESS )
1184         {
1185                 r = RegSetValueExW( hkey, szwSettings, 0,
1186                         REG_BINARY, (LPBYTE) cs, cs->cLength);
1187
1188                 RegCloseKey( hkey );
1189         }
1190
1191         return (r==ERROR_SUCCESS);
1192 }
1193
1194 /*************************************************************************
1195  * FileIconInit                                 [SHELL32.660]
1196  *
1197  */
1198 BOOL WINAPI FileIconInit(BOOL bFullInit)
1199 {       FIXME("(%s)\n", bFullInit ? "true" : "false");
1200         return 0;
1201 }
1202 /*************************************************************************
1203  * IsUserAdmin                                  [SHELL32.680] NT 4.0
1204  *
1205  */
1206 HRESULT WINAPI IsUserAdmin(void)
1207 {       FIXME("stub\n");
1208         return TRUE;
1209 }
1210
1211 /*************************************************************************
1212  * SHAllocShared                                [SHELL32.520]
1213  *
1214  * See shlwapi.SHAllocShared
1215  */
1216 HANDLE WINAPI SHAllocShared(LPVOID lpvData, DWORD dwSize, DWORD dwProcId)
1217 {
1218     GET_FUNC(pSHAllocShared, shlwapi, (char*)7, NULL);
1219     return pSHAllocShared(lpvData, dwSize, dwProcId);
1220 }
1221
1222 /*************************************************************************
1223  * SHLockShared                                 [SHELL32.521]
1224  *
1225  * See shlwapi.SHLockShared
1226  */
1227 LPVOID WINAPI SHLockShared(HANDLE hShared, DWORD dwProcId)
1228 {
1229     GET_FUNC(pSHLockShared, shlwapi, (char*)8, NULL);
1230     return pSHLockShared(hShared, dwProcId);
1231 }
1232
1233 /*************************************************************************
1234  * SHUnlockShared                               [SHELL32.522]
1235  *
1236  * See shlwapi.SHUnlockShared
1237  */
1238 BOOL WINAPI SHUnlockShared(LPVOID lpView)
1239 {
1240     GET_FUNC(pSHUnlockShared, shlwapi, (char*)9, FALSE);
1241     return pSHUnlockShared(lpView);
1242 }
1243
1244 /*************************************************************************
1245  * SHFreeShared                                 [SHELL32.523]
1246  *
1247  * See shlwapi.SHFreeShared
1248  */
1249 BOOL WINAPI SHFreeShared(HANDLE hShared, DWORD dwProcId)
1250 {
1251     GET_FUNC(pSHFreeShared, shlwapi, (char*)10, FALSE);
1252     return pSHFreeShared(hShared, dwProcId);
1253 }
1254
1255 /*************************************************************************
1256  * SetAppStartingCursor                         [SHELL32.99]
1257  */
1258 HRESULT WINAPI SetAppStartingCursor(HWND u, DWORD v)
1259 {       FIXME("hwnd=%p 0x%04lx stub\n",u,v );
1260         return 0;
1261 }
1262 /*************************************************************************
1263  * SHLoadOLE                                    [SHELL32.151]
1264  *
1265  */
1266 HRESULT WINAPI SHLoadOLE(LPARAM lParam)
1267 {       FIXME("0x%04lx stub\n",lParam);
1268         return S_OK;
1269 }
1270 /*************************************************************************
1271  * DriveType                                    [SHELL32.64]
1272  *
1273  */
1274 HRESULT WINAPI DriveType(DWORD u)
1275 {       FIXME("0x%04lx stub\n",u);
1276         return 0;
1277 }
1278 /*************************************************************************
1279  * SHAbortInvokeCommand                         [SHELL32.198]
1280  *
1281  */
1282 HRESULT WINAPI SHAbortInvokeCommand(void)
1283 {       FIXME("stub\n");
1284         return 1;
1285 }
1286 /*************************************************************************
1287  * SHOutOfMemoryMessageBox                      [SHELL32.126]
1288  *
1289  */
1290 int WINAPI SHOutOfMemoryMessageBox(
1291         HWND hwndOwner,
1292         LPCSTR lpCaption,
1293         UINT uType)
1294 {
1295         FIXME("%p %s 0x%08x stub\n",hwndOwner, lpCaption, uType);
1296         return 0;
1297 }
1298 /*************************************************************************
1299  * SHFlushClipboard                             [SHELL32.121]
1300  *
1301  */
1302 HRESULT WINAPI SHFlushClipboard(void)
1303 {       FIXME("stub\n");
1304         return 1;
1305 }
1306
1307 /*************************************************************************
1308  * SHWaitForFileToOpen                          [SHELL32.97]
1309  *
1310  */
1311 BOOL WINAPI SHWaitForFileToOpen(
1312         LPCITEMIDLIST pidl,
1313         DWORD dwFlags,
1314         DWORD dwTimeout)
1315 {
1316         FIXME("%p 0x%08lx 0x%08lx stub\n", pidl, dwFlags, dwTimeout);
1317         return 0;
1318 }
1319
1320 /************************************************************************
1321  *      @                               [SHELL32.654]
1322  *
1323  * NOTES: first parameter seems to be a pointer (same as passed to WriteCabinetState)
1324  * second one could be a size (0x0c). The size is the same as the structure saved to
1325  * HCU\Software\Microsoft\Windows\CurrentVersion\Explorer\CabinetState
1326  * I'm (js) guessing: this one is just ReadCabinetState ;-)
1327  */
1328 HRESULT WINAPI shell32_654 (CABINETSTATE *cs, int length)
1329 {
1330         TRACE("%p %d\n",cs,length);
1331         return ReadCabinetState(cs,length);
1332 }
1333
1334 /************************************************************************
1335  *      RLBuildListOfPaths                      [SHELL32.146]
1336  *
1337  * NOTES
1338  *   builds a DPA
1339  */
1340 DWORD WINAPI RLBuildListOfPaths (void)
1341 {       FIXME("stub\n");
1342         return 0;
1343 }
1344 /************************************************************************
1345  *      SHValidateUNC                           [SHELL32.173]
1346  *
1347  */
1348 HRESULT WINAPI SHValidateUNC (DWORD x, DWORD y, DWORD z)
1349 {
1350         FIXME("0x%08lx 0x%08lx 0x%08lx stub\n",x,y,z);
1351         return 0;
1352 }
1353
1354 /************************************************************************
1355  *      DoEnvironmentSubstA                     [SHELL32.@]
1356  *
1357  * Replace %KEYWORD% in the str with the value of variable KEYWORD
1358  * from environment. If it is not found the %KEYWORD% is left
1359  * intact. If the buffer is too small, str is not modified.
1360  *
1361  * pszString   [I] '\0' terminated string with %keyword%.
1362  *             [O] '\0' terminated string with %keyword% substituted.
1363  * cchString   [I] size of str.
1364  *
1365  * Return
1366  *     cchString length in the HIWORD;
1367  *     TRUE in LOWORD if subst was successful and FALSE in other case
1368  */
1369 DWORD WINAPI DoEnvironmentSubstA(LPSTR pszString, UINT cchString)
1370 {
1371     LPSTR dst;
1372     BOOL res = FALSE;
1373     FIXME("(%s, %d) stub\n", debugstr_a(pszString), cchString);
1374     if (pszString == NULL) /* Really return 0? */
1375         return 0;
1376     if ((dst = HeapAlloc(GetProcessHeap(), 0, cchString * sizeof(CHAR))))
1377     {
1378         DWORD num = ExpandEnvironmentStringsA(pszString, dst, cchString);
1379         if (num && num < cchString) /* dest buffer is too small */
1380         {
1381             res = TRUE;
1382             memcpy(pszString, dst, num);
1383         }
1384         HeapFree(GetProcessHeap(), 0, dst);
1385     }
1386     return MAKELONG(res,cchString); /* Always cchString? */
1387 }
1388
1389 /************************************************************************
1390  *      DoEnvironmentSubstW                     [SHELL32.@]
1391  *
1392  */
1393 DWORD WINAPI DoEnvironmentSubstW(LPWSTR pszString, UINT cchString)
1394 {
1395         FIXME("(%s, %d): stub\n", debugstr_w(pszString), cchString);
1396         return MAKELONG(FALSE,cchString);
1397 }
1398
1399 /************************************************************************
1400  *      DoEnvironmentSubst                      [SHELL32.53]
1401  *
1402  */
1403 DWORD WINAPI DoEnvironmentSubstAW(LPVOID x, UINT y)
1404 {
1405     if (SHELL_OsIsUnicode())
1406         return DoEnvironmentSubstW(x, y);
1407     return DoEnvironmentSubstA(x, y);
1408 }
1409
1410 /*************************************************************************
1411  *      @                             [SHELL32.243]
1412  *
1413  * Win98+ by-ordinal routine.  In Win98 this routine returns zero and
1414  * does nothing else.  Possibly this does something in NT or SHELL32 5.0?
1415  *
1416  */
1417
1418 BOOL WINAPI shell32_243(DWORD a, DWORD b)
1419 {
1420   return FALSE;
1421 }
1422
1423 /*************************************************************************
1424  *      @       [SHELL32.714]
1425  */
1426 DWORD WINAPI SHELL32_714(LPVOID x)
1427 {
1428         FIXME("(%s)stub\n", debugstr_w(x));
1429         return 0;
1430 }
1431
1432 /*************************************************************************
1433  *      SHAddFromPropSheetExtArray      [SHELL32.167]
1434  */
1435 DWORD WINAPI SHAddFromPropSheetExtArray(DWORD a, DWORD b, DWORD c)
1436 {
1437         FIXME("(%08lx,%08lx,%08lx)stub\n", a, b, c);
1438         return 0;
1439 }
1440
1441 /*************************************************************************
1442  *      SHCreatePropSheetExtArray       [SHELL32.168]
1443  */
1444 DWORD WINAPI SHCreatePropSheetExtArray(DWORD a, LPCSTR b, DWORD c)
1445 {
1446         FIXME("(%08lx,%s,%08lx)stub\n", a, debugstr_a(b), c);
1447         return 0;
1448 }
1449
1450 /*************************************************************************
1451  *      SHReplaceFromPropSheetExtArray  [SHELL32.170]
1452  */
1453 DWORD WINAPI SHReplaceFromPropSheetExtArray(DWORD a, DWORD b, DWORD c, DWORD d)
1454 {
1455         FIXME("(%08lx,%08lx,%08lx,%08lx)stub\n", a, b, c, d);
1456         return 0;
1457 }
1458
1459 /*************************************************************************
1460  *      SHDestroyPropSheetExtArray      [SHELL32.169]
1461  */
1462 DWORD WINAPI SHDestroyPropSheetExtArray(DWORD a)
1463 {
1464         FIXME("(%08lx)stub\n", a);
1465         return 0;
1466 }
1467
1468 /*************************************************************************
1469  *      CIDLData_CreateFromIDArray      [SHELL32.83]
1470  *
1471  *  Create IDataObject from PIDLs??
1472  */
1473 HRESULT WINAPI CIDLData_CreateFromIDArray(
1474         LPCITEMIDLIST pidlFolder,
1475         DWORD cpidlFiles,
1476         LPCITEMIDLIST *lppidlFiles,
1477         LPDATAOBJECT *ppdataObject)
1478 {
1479     UINT i;
1480     HWND hwnd = 0;   /*FIXME: who should be hwnd of owner? set to desktop */
1481
1482     TRACE("(%p, %ld, %p, %p)\n", pidlFolder, cpidlFiles, lppidlFiles, ppdataObject);
1483     if (TRACE_ON(pidl))
1484     {
1485         pdump (pidlFolder);
1486         for (i=0; i<cpidlFiles; i++) pdump (lppidlFiles[i]);
1487     }
1488     *ppdataObject = IDataObject_Constructor( hwnd, pidlFolder,
1489                                              lppidlFiles, cpidlFiles);
1490     if (*ppdataObject) return S_OK;
1491     return E_OUTOFMEMORY;
1492 }
1493
1494 /*************************************************************************
1495  * SHCreateStdEnumFmtEtc                        [SHELL32.74]
1496  *
1497  * NOTES
1498  *
1499  */
1500 HRESULT WINAPI SHCreateStdEnumFmtEtc(
1501         DWORD cFormats,
1502         const FORMATETC *lpFormats,
1503         LPENUMFORMATETC *ppenumFormatetc)
1504 {
1505         IEnumFORMATETC *pef;
1506         HRESULT hRes;
1507         TRACE("cf=%ld fe=%p pef=%p\n", cFormats, lpFormats, ppenumFormatetc);
1508
1509         pef = IEnumFORMATETC_Constructor(cFormats, lpFormats);
1510         if (!pef)
1511           return E_OUTOFMEMORY;
1512
1513         IEnumFORMATETC_AddRef(pef);
1514         hRes = IEnumFORMATETC_QueryInterface(pef, &IID_IEnumFORMATETC, (LPVOID*)ppenumFormatetc);
1515         IEnumFORMATETC_Release(pef);
1516
1517         return hRes;
1518 }
1519
1520
1521 /*************************************************************************
1522  *              SHELL32_256 (SHELL32.256)
1523  */
1524 HRESULT WINAPI SHELL32_256(LPDWORD lpdw0, LPDWORD lpdw1)
1525 {
1526     HRESULT ret = S_OK;
1527
1528     FIXME("stub %p 0x%08lx %p\n", lpdw0, lpdw0 ? *lpdw0 : 0, lpdw1);
1529
1530     if (!lpdw0 || *lpdw0 != 0x10)
1531         ret = E_INVALIDARG;
1532     else
1533     {
1534         LPVOID lpdata = 0;/*LocalAlloc(LMEM_ZEROINIT, 0x4E4);*/
1535
1536         if (!lpdata)
1537             ret = E_OUTOFMEMORY;
1538         else
1539         {
1540             /* Initialize and return unknown lpdata structure */
1541         }
1542     }
1543
1544     return ret;
1545 }
1546
1547 /*************************************************************************
1548  *              SHFindFiles (SHELL32.90)
1549  */
1550 BOOL WINAPI SHFindFiles( LPCITEMIDLIST pidlFolder, LPCITEMIDLIST pidlSaveFile )
1551 {
1552     FIXME("%p %p\n", pidlFolder, pidlSaveFile );
1553     return FALSE;
1554 }
1555
1556 /*************************************************************************
1557  *              SHUpdateImageW (SHELL32.192)
1558  *
1559  * Notifies the shell that an icon in the system image list has been changed.
1560  *
1561  * PARAMS
1562  *  pszHashItem [I] Path to file that contains the icon.
1563  *  iIndex      [I] Zero-based index of the icon in the file.
1564  *  uFlags      [I] Flags determining the icon attributes. See notes.
1565  *  iImageIndex [I] Index of the icon in the system image list.
1566  *
1567  * NOTES
1568  *  uFlags can be one or more of the following flags:
1569  *  GIL_NOTFILENAME - pszHashItem is not a file name.
1570  *  GIL_SIMULATEDOC - Create a document icon using the specified icon.
1571  */
1572 void WINAPI SHUpdateImageW(LPCWSTR pszHashItem, int iIndex, UINT uFlags, int iImageIndex)
1573 {
1574     FIXME("%s, %d, 0x%x, %d - stub\n", debugstr_w(pszHashItem), iIndex, uFlags, iImageIndex);
1575 }
1576
1577 VOID WINAPI SHUpdateImageA(LPCSTR pszHashItem, INT iIndex, UINT uFlags, INT iImageIndex)
1578 {
1579     FIXME("%s, %d, 0x%x, %d - stub\n", debugstr_a(pszHashItem), iIndex, uFlags, iImageIndex);
1580 }
1581
1582 INT WINAPI SHHandleUpdateImage(LPCITEMIDLIST pidlExtra)
1583 {
1584     FIXME("%p - stub\n", pidlExtra);
1585
1586     return -1;
1587 }
1588
1589 BOOL WINAPI SHObjectProperties(HWND hwnd, DWORD dwType, LPCWSTR szObject, LPCWSTR szPage)
1590 {
1591     FIXME("%p, 0x%08lx, %s, %s - stub\n", hwnd, dwType, debugstr_w(szObject), debugstr_w(szPage));
1592
1593     return TRUE;
1594 }
1595
1596 BOOL WINAPI SHGetNewLinkInfoA(LPCSTR pszLinkTo, LPCSTR pszDir, LPSTR pszName, BOOL *pfMustCopy,
1597                               UINT uFlags)
1598 {
1599     FIXME("%s, %s, %p, %p, 0x%08x - stub\n", debugstr_a(pszLinkTo), debugstr_a(pszDir),
1600           pszName, pfMustCopy, uFlags);
1601
1602     return FALSE;
1603 }
1604
1605 BOOL WINAPI SHGetNewLinkInfoW(LPCWSTR pszLinkTo, LPCWSTR pszDir, LPWSTR pszName, BOOL *pfMustCopy,
1606                               UINT uFlags)
1607 {
1608     FIXME("%s, %s, %p, %p, 0x%08x - stub\n", debugstr_w(pszLinkTo), debugstr_w(pszDir),
1609           pszName, pfMustCopy, uFlags);
1610
1611     return FALSE;
1612 }
1613
1614 HRESULT WINAPI SHStartNetConnectionDialog(HWND hwnd, LPCSTR pszRemoteName, DWORD dwType)
1615 {
1616     FIXME("%p, %s, 0x%08lx - stub\n", hwnd, debugstr_a(pszRemoteName), dwType);
1617
1618     return S_OK;
1619 }
1620
1621 HRESULT WINAPI SHEmptyRecycleBinA(HWND hwnd, LPCSTR pszRootPath, DWORD dwFlags)
1622 {
1623     FIXME("%p, %s, 0x%08lx - stub\n", hwnd, debugstr_a(pszRootPath), dwFlags);
1624
1625     return S_OK;
1626 }
1627
1628 HRESULT WINAPI SHEmptyRecycleBinW(HWND hwnd, LPCWSTR pszRootPath, DWORD dwFlags)
1629 {
1630     FIXME("%p, %s, 0x%08lx - stub\n", hwnd, debugstr_w(pszRootPath), dwFlags);
1631
1632     return S_OK;
1633 }
1634
1635 DWORD WINAPI SHFormatDrive(HWND hwnd, UINT drive, UINT fmtID, UINT options)
1636 {
1637     FIXME("%p, 0x%08x, 0x%08x, 0x%08x - stub\n", hwnd, drive, fmtID, options);
1638
1639     return SHFMT_NOFORMAT;
1640 }
1641
1642 HRESULT WINAPI SHQueryRecycleBinA(LPCSTR pszRootPath, LPSHQUERYRBINFO pSHQueryRBInfo)
1643 {
1644     FIXME("%s, %p - stub\n", debugstr_a(pszRootPath), pSHQueryRBInfo);
1645
1646     pSHQueryRBInfo->i64Size = 0;
1647     pSHQueryRBInfo->i64NumItems = 0;
1648
1649     return S_OK;
1650 }
1651
1652 HRESULT WINAPI SHQueryRecycleBinW(LPCWSTR pszRootPath, LPSHQUERYRBINFO pSHQueryRBInfo)
1653 {
1654     FIXME("%s, %p - stub\n", debugstr_w(pszRootPath), pSHQueryRBInfo);
1655
1656     pSHQueryRBInfo->i64Size = 0;
1657     pSHQueryRBInfo->i64NumItems = 0;
1658
1659     return S_OK;
1660 }