mshtml: Added IHTMLWindow2::focus implementation.
[wine] / dlls / shlwapi / ordinal.c
1 /*
2  * SHLWAPI ordinal functions
3  *
4  * Copyright 1997 Marcus Meissner
5  *           1998 Jürgen Schmied
6  *           2001-2003 Jon Griffiths
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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21  */
22
23 #include "config.h"
24 #include "wine/port.h"
25
26 #include <stdarg.h>
27 #include <stdio.h>
28 #include <string.h>
29
30 #define COBJMACROS
31 #define NONAMELESSUNION
32 #define NONAMELESSSTRUCT
33
34 #include "windef.h"
35 #include "winbase.h"
36 #include "winnls.h"
37 #include "winreg.h"
38 #include "wingdi.h"
39 #include "winuser.h"
40 #include "winver.h"
41 #include "winnetwk.h"
42 #include "mmsystem.h"
43 #include "objbase.h"
44 #include "exdisp.h"
45 #include "shdeprecated.h"
46 #include "shlobj.h"
47 #include "shlwapi.h"
48 #include "shellapi.h"
49 #include "commdlg.h"
50 #include "mlang.h"
51 #include "mshtmhst.h"
52 #include "wine/unicode.h"
53 #include "wine/debug.h"
54
55
56 WINE_DEFAULT_DEBUG_CHANNEL(shell);
57
58 /* DLL handles for late bound calls */
59 extern HINSTANCE shlwapi_hInstance;
60 extern DWORD SHLWAPI_ThreadRef_index;
61
62 HRESULT WINAPI IUnknown_QueryService(IUnknown*,REFGUID,REFIID,LPVOID*);
63 HRESULT WINAPI SHInvokeCommand(HWND,IShellFolder*,LPCITEMIDLIST,BOOL);
64 BOOL    WINAPI SHAboutInfoW(LPWSTR,DWORD);
65
66 /*
67  NOTES: Most functions exported by ordinal seem to be superfluous.
68  The reason for these functions to be there is to provide a wrapper
69  for unicode functions to provide these functions on systems without
70  unicode functions eg. win95/win98. Since we have such functions we just
71  call these. If running Wine with native DLLs, some late bound calls may
72  fail. However, it is better to implement the functions in the forward DLL
73  and recommend the builtin rather than reimplementing the calls here!
74 */
75
76 /*************************************************************************
77  * SHLWAPI_DupSharedHandle
78  *
79  * Internal implemetation of SHLWAPI_11.
80  */
81 static HANDLE SHLWAPI_DupSharedHandle(HANDLE hShared, DWORD dwDstProcId,
82                                       DWORD dwSrcProcId, DWORD dwAccess,
83                                       DWORD dwOptions)
84 {
85   HANDLE hDst, hSrc;
86   DWORD dwMyProcId = GetCurrentProcessId();
87   HANDLE hRet = NULL;
88
89   TRACE("(%p,%d,%d,%08x,%08x)\n", hShared, dwDstProcId, dwSrcProcId,
90         dwAccess, dwOptions);
91
92   /* Get dest process handle */
93   if (dwDstProcId == dwMyProcId)
94     hDst = GetCurrentProcess();
95   else
96     hDst = OpenProcess(PROCESS_DUP_HANDLE, 0, dwDstProcId);
97
98   if (hDst)
99   {
100     /* Get src process handle */
101     if (dwSrcProcId == dwMyProcId)
102       hSrc = GetCurrentProcess();
103     else
104       hSrc = OpenProcess(PROCESS_DUP_HANDLE, 0, dwSrcProcId);
105
106     if (hSrc)
107     {
108       /* Make handle available to dest process */
109       if (!DuplicateHandle(hDst, hShared, hSrc, &hRet,
110                            dwAccess, 0, dwOptions | DUPLICATE_SAME_ACCESS))
111         hRet = NULL;
112
113       if (dwSrcProcId != dwMyProcId)
114         CloseHandle(hSrc);
115     }
116
117     if (dwDstProcId != dwMyProcId)
118       CloseHandle(hDst);
119   }
120
121   TRACE("Returning handle %p\n", hRet);
122   return hRet;
123 }
124
125 /*************************************************************************
126  * @  [SHLWAPI.7]
127  *
128  * Create a block of sharable memory and initialise it with data.
129  *
130  * PARAMS
131  * lpvData  [I] Pointer to data to write
132  * dwSize   [I] Size of data
133  * dwProcId [I] ID of process owning data
134  *
135  * RETURNS
136  * Success: A shared memory handle
137  * Failure: NULL
138  *
139  * NOTES
140  * Ordinals 7-11 provide a set of calls to create shared memory between a
141  * group of processes. The shared memory is treated opaquely in that its size
142  * is not exposed to clients who map it. This is accomplished by storing
143  * the size of the map as the first DWORD of mapped data, and then offsetting
144  * the view pointer returned by this size.
145  *
146  */
147 HANDLE WINAPI SHAllocShared(LPCVOID lpvData, DWORD dwSize, DWORD dwProcId)
148 {
149   HANDLE hMap;
150   LPVOID pMapped;
151   HANDLE hRet = NULL;
152
153   TRACE("(%p,%d,%d)\n", lpvData, dwSize, dwProcId);
154
155   /* Create file mapping of the correct length */
156   hMap = CreateFileMappingA(INVALID_HANDLE_VALUE, NULL, FILE_MAP_READ, 0,
157                             dwSize + sizeof(dwSize), NULL);
158   if (!hMap)
159     return hRet;
160
161   /* Get a view in our process address space */
162   pMapped = MapViewOfFile(hMap, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
163
164   if (pMapped)
165   {
166     /* Write size of data, followed by the data, to the view */
167     *((DWORD*)pMapped) = dwSize;
168     if (lpvData)
169       memcpy((char *) pMapped + sizeof(dwSize), lpvData, dwSize);
170
171     /* Release view. All further views mapped will be opaque */
172     UnmapViewOfFile(pMapped);
173     hRet = SHLWAPI_DupSharedHandle(hMap, dwProcId,
174                                    GetCurrentProcessId(), FILE_MAP_ALL_ACCESS,
175                                    DUPLICATE_SAME_ACCESS);
176   }
177
178   CloseHandle(hMap);
179   return hRet;
180 }
181
182 /*************************************************************************
183  * @ [SHLWAPI.8]
184  *
185  * Get a pointer to a block of shared memory from a shared memory handle.
186  *
187  * PARAMS
188  * hShared  [I] Shared memory handle
189  * dwProcId [I] ID of process owning hShared
190  *
191  * RETURNS
192  * Success: A pointer to the shared memory
193  * Failure: NULL
194  *
195  */
196 PVOID WINAPI SHLockShared(HANDLE hShared, DWORD dwProcId)
197 {
198   HANDLE hDup;
199   LPVOID pMapped;
200
201   TRACE("(%p %d)\n", hShared, dwProcId);
202
203   /* Get handle to shared memory for current process */
204   hDup = SHLWAPI_DupSharedHandle(hShared, dwProcId, GetCurrentProcessId(),
205                                  FILE_MAP_ALL_ACCESS, 0);
206   /* Get View */
207   pMapped = MapViewOfFile(hDup, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
208   CloseHandle(hDup);
209
210   if (pMapped)
211     return (char *) pMapped + sizeof(DWORD); /* Hide size */
212   return NULL;
213 }
214
215 /*************************************************************************
216  * @ [SHLWAPI.9]
217  *
218  * Release a pointer to a block of shared memory.
219  *
220  * PARAMS
221  * lpView [I] Shared memory pointer
222  *
223  * RETURNS
224  * Success: TRUE
225  * Failure: FALSE
226  *
227  */
228 BOOL WINAPI SHUnlockShared(LPVOID lpView)
229 {
230   TRACE("(%p)\n", lpView);
231   return UnmapViewOfFile((char *) lpView - sizeof(DWORD)); /* Include size */
232 }
233
234 /*************************************************************************
235  * @ [SHLWAPI.10]
236  *
237  * Destroy a block of sharable memory.
238  *
239  * PARAMS
240  * hShared  [I] Shared memory handle
241  * dwProcId [I] ID of process owning hShared
242  *
243  * RETURNS
244  * Success: TRUE
245  * Failure: FALSE
246  *
247  */
248 BOOL WINAPI SHFreeShared(HANDLE hShared, DWORD dwProcId)
249 {
250   HANDLE hClose;
251
252   TRACE("(%p %d)\n", hShared, dwProcId);
253
254   /* Get a copy of the handle for our process, closing the source handle */
255   hClose = SHLWAPI_DupSharedHandle(hShared, dwProcId, GetCurrentProcessId(),
256                                    FILE_MAP_ALL_ACCESS,DUPLICATE_CLOSE_SOURCE);
257   /* Close local copy */
258   return CloseHandle(hClose);
259 }
260
261 /*************************************************************************
262  * @   [SHLWAPI.11]
263  *
264  * Copy a sharable memory handle from one process to another.
265  *
266  * PARAMS
267  * hShared     [I] Shared memory handle to duplicate
268  * dwDstProcId [I] ID of the process wanting the duplicated handle
269  * dwSrcProcId [I] ID of the process owning hShared
270  * dwAccess    [I] Desired DuplicateHandle() access
271  * dwOptions   [I] Desired DuplicateHandle() options
272  *
273  * RETURNS
274  * Success: A handle suitable for use by the dwDstProcId process.
275  * Failure: A NULL handle.
276  *
277  */
278 HANDLE WINAPI SHMapHandle(HANDLE hShared, DWORD dwDstProcId, DWORD dwSrcProcId,
279                           DWORD dwAccess, DWORD dwOptions)
280 {
281   HANDLE hRet;
282
283   hRet = SHLWAPI_DupSharedHandle(hShared, dwDstProcId, dwSrcProcId,
284                                  dwAccess, dwOptions);
285   return hRet;
286 }
287
288 /*************************************************************************
289  *      @       [SHLWAPI.13]
290  *
291  * Create and register a clipboard enumerator for a web browser.
292  *
293  * PARAMS
294  *  lpBC      [I] Binding context
295  *  lpUnknown [I] An object exposing the IWebBrowserApp interface
296  *
297  * RETURNS
298  *  Success: S_OK.
299  *  Failure: An HRESULT error code.
300  *
301  * NOTES
302  *  The enumerator is stored as a property of the web browser. If it does not
303  *  yet exist, it is created and set before being registered.
304  */
305 HRESULT WINAPI RegisterDefaultAcceptHeaders(LPBC lpBC, IUnknown *lpUnknown)
306 {
307   static const WCHAR szProperty[] = { '{','D','0','F','C','A','4','2','0',
308       '-','D','3','F','5','-','1','1','C','F', '-','B','2','1','1','-','0',
309       '0','A','A','0','0','4','A','E','8','3','7','}','\0' };
310   BSTR property;
311   IEnumFORMATETC* pIEnumFormatEtc = NULL;
312   VARIANTARG var;
313   HRESULT hr;
314   IWebBrowserApp* pBrowser;
315
316   TRACE("(%p, %p)\n", lpBC, lpUnknown);
317
318   hr = IUnknown_QueryService(lpUnknown, &IID_IWebBrowserApp, &IID_IWebBrowserApp, (void**)&pBrowser);
319   if (FAILED(hr))
320     return hr;
321
322   V_VT(&var) = VT_EMPTY;
323
324   /* The property we get is the browsers clipboard enumerator */
325   property = SysAllocString(szProperty);
326   hr = IWebBrowserApp_GetProperty(pBrowser, property, &var);
327   SysFreeString(property);
328   if (FAILED(hr)) goto exit;
329
330   if (V_VT(&var) == VT_EMPTY)
331   {
332     /* Iterate through accepted documents and RegisterClipBoardFormatA() them */
333     char szKeyBuff[128], szValueBuff[128];
334     DWORD dwKeySize, dwValueSize, dwRet = 0, dwCount = 0, dwNumValues, dwType;
335     FORMATETC* formatList, *format;
336     HKEY hDocs;
337
338     TRACE("Registering formats and creating IEnumFORMATETC instance\n");
339
340     if (!RegOpenKeyA(HKEY_LOCAL_MACHINE, "Software\\Microsoft\\Windows\\Current"
341                      "Version\\Internet Settings\\Accepted Documents", &hDocs))
342     {
343       hr = E_FAIL;
344       goto exit;
345     }
346
347     /* Get count of values in key */
348     while (!dwRet)
349     {
350       dwKeySize = sizeof(szKeyBuff);
351       dwRet = RegEnumValueA(hDocs,dwCount,szKeyBuff,&dwKeySize,0,&dwType,0,0);
352       dwCount++;
353     }
354
355     dwNumValues = dwCount;
356
357     /* Note: dwCount = number of items + 1; The extra item is the end node */
358     format = formatList = HeapAlloc(GetProcessHeap(), 0, dwCount * sizeof(FORMATETC));
359     if (!formatList)
360     {
361       RegCloseKey(hDocs);
362       hr = E_OUTOFMEMORY;
363       goto exit;
364     }
365
366     if (dwNumValues > 1)
367     {
368       dwRet = 0;
369       dwCount = 0;
370
371       dwNumValues--;
372
373       /* Register clipboard formats for the values and populate format list */
374       while(!dwRet && dwCount < dwNumValues)
375       {
376         dwKeySize = sizeof(szKeyBuff);
377         dwValueSize = sizeof(szValueBuff);
378         dwRet = RegEnumValueA(hDocs, dwCount, szKeyBuff, &dwKeySize, 0, &dwType,
379                               (PBYTE)szValueBuff, &dwValueSize);
380         if (!dwRet)
381         {
382           HeapFree(GetProcessHeap(), 0, formatList);
383           RegCloseKey(hDocs);
384           hr = E_FAIL;
385           goto exit;
386         }
387
388         format->cfFormat = RegisterClipboardFormatA(szValueBuff);
389         format->ptd = NULL;
390         format->dwAspect = 1;
391         format->lindex = 4;
392         format->tymed = -1;
393
394         format++;
395         dwCount++;
396       }
397     }
398
399     RegCloseKey(hDocs);
400
401     /* Terminate the (maybe empty) list, last entry has a cfFormat of 0 */
402     format->cfFormat = 0;
403     format->ptd = NULL;
404     format->dwAspect = 1;
405     format->lindex = 4;
406     format->tymed = -1;
407
408     /* Create a clipboard enumerator */
409     hr = CreateFormatEnumerator(dwNumValues, formatList, &pIEnumFormatEtc);
410     HeapFree(GetProcessHeap(), 0, formatList);
411     if (FAILED(hr)) goto exit;
412
413     /* Set our enumerator as the browsers property */
414     V_VT(&var) = VT_UNKNOWN;
415     V_UNKNOWN(&var) = (IUnknown*)pIEnumFormatEtc;
416
417     property = SysAllocString(szProperty);
418     hr = IWebBrowserApp_PutProperty(pBrowser, property, var);
419     SysFreeString(property);
420     if (FAILED(hr))
421     {
422        IEnumFORMATETC_Release(pIEnumFormatEtc);
423        goto exit;
424     }
425   }
426
427   if (V_VT(&var) == VT_UNKNOWN)
428   {
429     /* Our variant is holding the clipboard enumerator */
430     IUnknown* pIUnknown = V_UNKNOWN(&var);
431     IEnumFORMATETC* pClone = NULL;
432
433     TRACE("Retrieved IEnumFORMATETC property\n");
434
435     /* Get an IEnumFormatEtc interface from the variants value */
436     pIEnumFormatEtc = NULL;
437     hr = IUnknown_QueryInterface(pIUnknown, &IID_IEnumFORMATETC, (void**)&pIEnumFormatEtc);
438     if (hr == S_OK && pIEnumFormatEtc)
439     {
440       /* Clone and register the enumerator */
441       hr = IEnumFORMATETC_Clone(pIEnumFormatEtc, &pClone);
442       if (hr == S_OK && pClone)
443       {
444         RegisterFormatEnumerator(lpBC, pClone, 0);
445
446         IEnumFORMATETC_Release(pClone);
447       }
448
449       IEnumFORMATETC_Release(pIUnknown);
450     }
451     IUnknown_Release(V_UNKNOWN(&var));
452   }
453
454 exit:
455   IWebBrowserApp_Release(pBrowser);
456   return hr;
457 }
458
459 /*************************************************************************
460  *      @       [SHLWAPI.15]
461  *
462  * Get Explorers "AcceptLanguage" setting.
463  *
464  * PARAMS
465  *  langbuf [O] Destination for language string
466  *  buflen  [I] Length of langbuf in characters
467  *          [0] Success: used length of langbuf
468  *
469  * RETURNS
470  *  Success: S_OK.   langbuf is set to the language string found.
471  *  Failure: E_FAIL, If any arguments are invalid, error occurred, or Explorer
472  *           does not contain the setting.
473  *           HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER), If the buffer is not big enough
474  */
475 HRESULT WINAPI GetAcceptLanguagesW( LPWSTR langbuf, LPDWORD buflen)
476 {
477     static const WCHAR szkeyW[] = {
478         'S','o','f','t','w','a','r','e','\\',
479         'M','i','c','r','o','s','o','f','t','\\',
480         'I','n','t','e','r','n','e','t',' ','E','x','p','l','o','r','e','r','\\',
481         'I','n','t','e','r','n','a','t','i','o','n','a','l',0};
482     static const WCHAR valueW[] = {
483         'A','c','c','e','p','t','L','a','n','g','u','a','g','e',0};
484     DWORD mystrlen, mytype;
485     DWORD len;
486     HKEY mykey;
487     LCID mylcid;
488     WCHAR *mystr;
489     LONG lres;
490
491     TRACE("(%p, %p) *%p: %d\n", langbuf, buflen, buflen, buflen ? *buflen : -1);
492
493     if(!langbuf || !buflen || !*buflen)
494         return E_FAIL;
495
496     mystrlen = (*buflen > 20) ? *buflen : 20 ;
497     len = mystrlen * sizeof(WCHAR);
498     mystr = HeapAlloc(GetProcessHeap(), 0, len);
499     mystr[0] = 0;
500     RegOpenKeyW(HKEY_CURRENT_USER, szkeyW, &mykey);
501     lres = RegQueryValueExW(mykey, valueW, 0, &mytype, (PBYTE)mystr, &len);
502     RegCloseKey(mykey);
503     len = lstrlenW(mystr);
504
505     if (!lres && (*buflen > len)) {
506         lstrcpyW(langbuf, mystr);
507         *buflen = len;
508         HeapFree(GetProcessHeap(), 0, mystr);
509         return S_OK;
510     }
511
512     /* Did not find a value in the registry or the user buffer is too small */
513     mylcid = GetUserDefaultLCID();
514     LcidToRfc1766W(mylcid, mystr, mystrlen);
515     len = lstrlenW(mystr);
516
517     memcpy( langbuf, mystr, min(*buflen, len+1)*sizeof(WCHAR) );
518     HeapFree(GetProcessHeap(), 0, mystr);
519
520     if (*buflen > len) {
521         *buflen = len;
522         return S_OK;
523     }
524
525     *buflen = 0;
526     return __HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER);
527 }
528
529 /*************************************************************************
530  *      @       [SHLWAPI.14]
531  *
532  * Ascii version of GetAcceptLanguagesW.
533  */
534 HRESULT WINAPI GetAcceptLanguagesA( LPSTR langbuf, LPDWORD buflen)
535 {
536     WCHAR *langbufW;
537     DWORD buflenW, convlen;
538     HRESULT retval;
539
540     TRACE("(%p, %p) *%p: %d\n", langbuf, buflen, buflen, buflen ? *buflen : -1);
541
542     if(!langbuf || !buflen || !*buflen) return E_FAIL;
543
544     buflenW = *buflen;
545     langbufW = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * buflenW);
546     retval = GetAcceptLanguagesW(langbufW, &buflenW);
547
548     if (retval == S_OK)
549     {
550         convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, -1, langbuf, *buflen, NULL, NULL);
551         convlen--;  /* do not count the terminating 0 */
552     }
553     else  /* copy partial string anyway */
554     {
555         convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, *buflen, langbuf, *buflen, NULL, NULL);
556         if (convlen < *buflen)
557         {
558             langbuf[convlen] = 0;
559             convlen--;  /* do not count the terminating 0 */
560         }
561         else
562         {
563             convlen = *buflen;
564         }
565     }
566     *buflen = buflenW ? convlen : 0;
567
568     HeapFree(GetProcessHeap(), 0, langbufW);
569     return retval;
570 }
571
572 /*************************************************************************
573  *      @       [SHLWAPI.23]
574  *
575  * Convert a GUID to a string.
576  *
577  * PARAMS
578  *  guid     [I] GUID to convert
579  *  lpszDest [O] Destination for string
580  *  cchMax   [I] Length of output buffer
581  *
582  * RETURNS
583  *  The length of the string created.
584  */
585 INT WINAPI SHStringFromGUIDA(REFGUID guid, LPSTR lpszDest, INT cchMax)
586 {
587   char xguid[40];
588   INT iLen;
589
590   TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
591
592   sprintf(xguid, "{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}",
593           guid->Data1, guid->Data2, guid->Data3,
594           guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
595           guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
596
597   iLen = strlen(xguid) + 1;
598
599   if (iLen > cchMax)
600     return 0;
601   memcpy(lpszDest, xguid, iLen);
602   return iLen;
603 }
604
605 /*************************************************************************
606  *      @       [SHLWAPI.24]
607  *
608  * Convert a GUID to a string.
609  *
610  * PARAMS
611  *  guid [I] GUID to convert
612  *  str  [O] Destination for string
613  *  cmax [I] Length of output buffer
614  *
615  * RETURNS
616  *  The length of the string created.
617  */
618 INT WINAPI SHStringFromGUIDW(REFGUID guid, LPWSTR lpszDest, INT cchMax)
619 {
620   WCHAR xguid[40];
621   INT iLen;
622   static const WCHAR wszFormat[] = {'{','%','0','8','l','X','-','%','0','4','X','-','%','0','4','X','-',
623       '%','0','2','X','%','0','2','X','-','%','0','2','X','%','0','2','X','%','0','2','X','%','0','2',
624       'X','%','0','2','X','%','0','2','X','}',0};
625
626   TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
627
628   sprintfW(xguid, wszFormat, guid->Data1, guid->Data2, guid->Data3,
629           guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
630           guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
631
632   iLen = strlenW(xguid) + 1;
633
634   if (iLen > cchMax)
635     return 0;
636   memcpy(lpszDest, xguid, iLen*sizeof(WCHAR));
637   return iLen;
638 }
639
640 /*************************************************************************
641  *      @       [SHLWAPI.29]
642  *
643  * Determine if a Unicode character is a space.
644  *
645  * PARAMS
646  *  wc [I] Character to check.
647  *
648  * RETURNS
649  *  TRUE, if wc is a space,
650  *  FALSE otherwise.
651  */
652 BOOL WINAPI IsCharSpaceW(WCHAR wc)
653 {
654     WORD CharType;
655
656     return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_SPACE);
657 }
658
659 /*************************************************************************
660  *      @       [SHLWAPI.30]
661  *
662  * Determine if a Unicode character is a blank.
663  *
664  * PARAMS
665  *  wc [I] Character to check.
666  *
667  * RETURNS
668  *  TRUE, if wc is a blank,
669  *  FALSE otherwise.
670  *
671  */
672 BOOL WINAPI IsCharBlankW(WCHAR wc)
673 {
674     WORD CharType;
675
676     return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_BLANK);
677 }
678
679 /*************************************************************************
680  *      @       [SHLWAPI.31]
681  *
682  * Determine if a Unicode character is punctuation.
683  *
684  * PARAMS
685  *  wc [I] Character to check.
686  *
687  * RETURNS
688  *  TRUE, if wc is punctuation,
689  *  FALSE otherwise.
690  */
691 BOOL WINAPI IsCharPunctW(WCHAR wc)
692 {
693     WORD CharType;
694
695     return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_PUNCT);
696 }
697
698 /*************************************************************************
699  *      @       [SHLWAPI.32]
700  *
701  * Determine if a Unicode character is a control character.
702  *
703  * PARAMS
704  *  wc [I] Character to check.
705  *
706  * RETURNS
707  *  TRUE, if wc is a control character,
708  *  FALSE otherwise.
709  */
710 BOOL WINAPI IsCharCntrlW(WCHAR wc)
711 {
712     WORD CharType;
713
714     return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_CNTRL);
715 }
716
717 /*************************************************************************
718  *      @       [SHLWAPI.33]
719  *
720  * Determine if a Unicode character is a digit.
721  *
722  * PARAMS
723  *  wc [I] Character to check.
724  *
725  * RETURNS
726  *  TRUE, if wc is a digit,
727  *  FALSE otherwise.
728  */
729 BOOL WINAPI IsCharDigitW(WCHAR wc)
730 {
731     WORD CharType;
732
733     return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_DIGIT);
734 }
735
736 /*************************************************************************
737  *      @       [SHLWAPI.34]
738  *
739  * Determine if a Unicode character is a hex digit.
740  *
741  * PARAMS
742  *  wc [I] Character to check.
743  *
744  * RETURNS
745  *  TRUE, if wc is a hex digit,
746  *  FALSE otherwise.
747  */
748 BOOL WINAPI IsCharXDigitW(WCHAR wc)
749 {
750     WORD CharType;
751
752     return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_XDIGIT);
753 }
754
755 /*************************************************************************
756  *      @       [SHLWAPI.35]
757  *
758  */
759 BOOL WINAPI GetStringType3ExW(LPWSTR src, INT count, LPWORD type)
760 {
761     return GetStringTypeW(CT_CTYPE3, src, count, type);
762 }
763
764 /*************************************************************************
765  *      @       [SHLWAPI.151]
766  *
767  * Compare two Ascii strings up to a given length.
768  *
769  * PARAMS
770  *  lpszSrc [I] Source string
771  *  lpszCmp [I] String to compare to lpszSrc
772  *  len     [I] Maximum length
773  *
774  * RETURNS
775  *  A number greater than, less than or equal to 0 depending on whether
776  *  lpszSrc is greater than, less than or equal to lpszCmp.
777  */
778 DWORD WINAPI StrCmpNCA(LPCSTR lpszSrc, LPCSTR lpszCmp, INT len)
779 {
780     return StrCmpNA(lpszSrc, lpszCmp, len);
781 }
782
783 /*************************************************************************
784  *      @       [SHLWAPI.152]
785  *
786  * Unicode version of StrCmpNCA.
787  */
788 DWORD WINAPI StrCmpNCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, INT len)
789 {
790     return StrCmpNW(lpszSrc, lpszCmp, len);
791 }
792
793 /*************************************************************************
794  *      @       [SHLWAPI.153]
795  *
796  * Compare two Ascii strings up to a given length, ignoring case.
797  *
798  * PARAMS
799  *  lpszSrc [I] Source string
800  *  lpszCmp [I] String to compare to lpszSrc
801  *  len     [I] Maximum length
802  *
803  * RETURNS
804  *  A number greater than, less than or equal to 0 depending on whether
805  *  lpszSrc is greater than, less than or equal to lpszCmp.
806  */
807 DWORD WINAPI StrCmpNICA(LPCSTR lpszSrc, LPCSTR lpszCmp, DWORD len)
808 {
809     return StrCmpNIA(lpszSrc, lpszCmp, len);
810 }
811
812 /*************************************************************************
813  *      @       [SHLWAPI.154]
814  *
815  * Unicode version of StrCmpNICA.
816  */
817 DWORD WINAPI StrCmpNICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, DWORD len)
818 {
819     return StrCmpNIW(lpszSrc, lpszCmp, len);
820 }
821
822 /*************************************************************************
823  *      @       [SHLWAPI.155]
824  *
825  * Compare two Ascii strings.
826  *
827  * PARAMS
828  *  lpszSrc [I] Source string
829  *  lpszCmp [I] String to compare to lpszSrc
830  *
831  * RETURNS
832  *  A number greater than, less than or equal to 0 depending on whether
833  *  lpszSrc is greater than, less than or equal to lpszCmp.
834  */
835 DWORD WINAPI StrCmpCA(LPCSTR lpszSrc, LPCSTR lpszCmp)
836 {
837     return lstrcmpA(lpszSrc, lpszCmp);
838 }
839
840 /*************************************************************************
841  *      @       [SHLWAPI.156]
842  *
843  * Unicode version of StrCmpCA.
844  */
845 DWORD WINAPI StrCmpCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
846 {
847     return lstrcmpW(lpszSrc, lpszCmp);
848 }
849
850 /*************************************************************************
851  *      @       [SHLWAPI.157]
852  *
853  * Compare two Ascii strings, ignoring case.
854  *
855  * PARAMS
856  *  lpszSrc [I] Source string
857  *  lpszCmp [I] String to compare to lpszSrc
858  *
859  * RETURNS
860  *  A number greater than, less than or equal to 0 depending on whether
861  *  lpszSrc is greater than, less than or equal to lpszCmp.
862  */
863 DWORD WINAPI StrCmpICA(LPCSTR lpszSrc, LPCSTR lpszCmp)
864 {
865     return lstrcmpiA(lpszSrc, lpszCmp);
866 }
867
868 /*************************************************************************
869  *      @       [SHLWAPI.158]
870  *
871  * Unicode version of StrCmpICA.
872  */
873 DWORD WINAPI StrCmpICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
874 {
875     return lstrcmpiW(lpszSrc, lpszCmp);
876 }
877
878 /*************************************************************************
879  *      @       [SHLWAPI.160]
880  *
881  * Get an identification string for the OS and explorer.
882  *
883  * PARAMS
884  *  lpszDest  [O] Destination for Id string
885  *  dwDestLen [I] Length of lpszDest
886  *
887  * RETURNS
888  *  TRUE,  If the string was created successfully
889  *  FALSE, Otherwise
890  */
891 BOOL WINAPI SHAboutInfoA(LPSTR lpszDest, DWORD dwDestLen)
892 {
893   WCHAR buff[2084];
894
895   TRACE("(%p,%d)\n", lpszDest, dwDestLen);
896
897   if (lpszDest && SHAboutInfoW(buff, dwDestLen))
898   {
899     WideCharToMultiByte(CP_ACP, 0, buff, -1, lpszDest, dwDestLen, NULL, NULL);
900     return TRUE;
901   }
902   return FALSE;
903 }
904
905 /*************************************************************************
906  *      @       [SHLWAPI.161]
907  *
908  * Unicode version of SHAboutInfoA.
909  */
910 BOOL WINAPI SHAboutInfoW(LPWSTR lpszDest, DWORD dwDestLen)
911 {
912   static const WCHAR szIEKey[] = { 'S','O','F','T','W','A','R','E','\\',
913     'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
914     ' ','E','x','p','l','o','r','e','r','\0' };
915   static const WCHAR szWinNtKey[] = { 'S','O','F','T','W','A','R','E','\\',
916     'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s',' ',
917     'N','T','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
918   static const WCHAR szWinKey[] = { 'S','O','F','T','W','A','R','E','\\',
919     'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
920     'C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
921   static const WCHAR szRegKey[] = { 'S','O','F','T','W','A','R','E','\\',
922     'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
923     ' ','E','x','p','l','o','r','e','r','\\',
924     'R','e','g','i','s','t','r','a','t','i','o','n','\0' };
925   static const WCHAR szVersion[] = { 'V','e','r','s','i','o','n','\0' };
926   static const WCHAR szCustomized[] = { 'C','u','s','t','o','m','i','z','e','d',
927     'V','e','r','s','i','o','n','\0' };
928   static const WCHAR szOwner[] = { 'R','e','g','i','s','t','e','r','e','d',
929     'O','w','n','e','r','\0' };
930   static const WCHAR szOrg[] = { 'R','e','g','i','s','t','e','r','e','d',
931     'O','r','g','a','n','i','z','a','t','i','o','n','\0' };
932   static const WCHAR szProduct[] = { 'P','r','o','d','u','c','t','I','d','\0' };
933   static const WCHAR szUpdate[] = { 'I','E','A','K',
934     'U','p','d','a','t','e','U','r','l','\0' };
935   static const WCHAR szHelp[] = { 'I','E','A','K',
936     'H','e','l','p','S','t','r','i','n','g','\0' };
937   WCHAR buff[2084];
938   HKEY hReg;
939   DWORD dwType, dwLen;
940
941   TRACE("(%p,%d)\n", lpszDest, dwDestLen);
942
943   if (!lpszDest)
944     return FALSE;
945
946   *lpszDest = '\0';
947
948   /* Try the NT key first, followed by 95/98 key */
949   if (RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinNtKey, 0, KEY_READ, &hReg) &&
950       RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinKey, 0, KEY_READ, &hReg))
951     return FALSE;
952
953   /* OS Version */
954   buff[0] = '\0';
955   dwLen = 30;
956   if (!SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey, szVersion, &dwType, buff, &dwLen))
957   {
958     DWORD dwStrLen = strlenW(buff);
959     dwLen = 30 - dwStrLen;
960     SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey,
961                 szCustomized, &dwType, buff+dwStrLen, &dwLen);
962   }
963   StrCatBuffW(lpszDest, buff, dwDestLen);
964
965   /* ~Registered Owner */
966   buff[0] = '~';
967   dwLen = 256;
968   if (SHGetValueW(hReg, szOwner, 0, &dwType, buff+1, &dwLen))
969     buff[1] = '\0';
970   StrCatBuffW(lpszDest, buff, dwDestLen);
971
972   /* ~Registered Organization */
973   dwLen = 256;
974   if (SHGetValueW(hReg, szOrg, 0, &dwType, buff+1, &dwLen))
975     buff[1] = '\0';
976   StrCatBuffW(lpszDest, buff, dwDestLen);
977
978   /* FIXME: Not sure where this number comes from  */
979   buff[0] = '~';
980   buff[1] = '0';
981   buff[2] = '\0';
982   StrCatBuffW(lpszDest, buff, dwDestLen);
983
984   /* ~Product Id */
985   dwLen = 256;
986   if (SHGetValueW(HKEY_LOCAL_MACHINE, szRegKey, szProduct, &dwType, buff+1, &dwLen))
987     buff[1] = '\0';
988   StrCatBuffW(lpszDest, buff, dwDestLen);
989
990   /* ~IE Update Url */
991   dwLen = 2048;
992   if(SHGetValueW(HKEY_LOCAL_MACHINE, szWinKey, szUpdate, &dwType, buff+1, &dwLen))
993     buff[1] = '\0';
994   StrCatBuffW(lpszDest, buff, dwDestLen);
995
996   /* ~IE Help String */
997   dwLen = 256;
998   if(SHGetValueW(hReg, szHelp, 0, &dwType, buff+1, &dwLen))
999     buff[1] = '\0';
1000   StrCatBuffW(lpszDest, buff, dwDestLen);
1001
1002   RegCloseKey(hReg);
1003   return TRUE;
1004 }
1005
1006 /*************************************************************************
1007  *      @       [SHLWAPI.163]
1008  *
1009  * Call IOleCommandTarget_QueryStatus() on an object.
1010  *
1011  * PARAMS
1012  *  lpUnknown     [I] Object supporting the IOleCommandTarget interface
1013  *  pguidCmdGroup [I] GUID for the command group
1014  *  cCmds         [I]
1015  *  prgCmds       [O] Commands
1016  *  pCmdText      [O] Command text
1017  *
1018  * RETURNS
1019  *  Success: S_OK.
1020  *  Failure: E_FAIL, if lpUnknown is NULL.
1021  *           E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
1022  *           Otherwise, an error code from IOleCommandTarget_QueryStatus().
1023  */
1024 HRESULT WINAPI IUnknown_QueryStatus(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
1025                            ULONG cCmds, OLECMD *prgCmds, OLECMDTEXT* pCmdText)
1026 {
1027   HRESULT hRet = E_FAIL;
1028
1029   TRACE("(%p,%p,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, cCmds, prgCmds, pCmdText);
1030
1031   if (lpUnknown)
1032   {
1033     IOleCommandTarget* lpOle;
1034
1035     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
1036                                    (void**)&lpOle);
1037
1038     if (SUCCEEDED(hRet) && lpOle)
1039     {
1040       hRet = IOleCommandTarget_QueryStatus(lpOle, pguidCmdGroup, cCmds,
1041                                            prgCmds, pCmdText);
1042       IOleCommandTarget_Release(lpOle);
1043     }
1044   }
1045   return hRet;
1046 }
1047
1048 /*************************************************************************
1049  *      @               [SHLWAPI.164]
1050  *
1051  * Call IOleCommandTarget_Exec() on an object.
1052  *
1053  * PARAMS
1054  *  lpUnknown     [I] Object supporting the IOleCommandTarget interface
1055  *  pguidCmdGroup [I] GUID for the command group
1056  *
1057  * RETURNS
1058  *  Success: S_OK.
1059  *  Failure: E_FAIL, if lpUnknown is NULL.
1060  *           E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
1061  *           Otherwise, an error code from IOleCommandTarget_Exec().
1062  */
1063 HRESULT WINAPI IUnknown_Exec(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
1064                            DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
1065                            VARIANT* pvaOut)
1066 {
1067   HRESULT hRet = E_FAIL;
1068
1069   TRACE("(%p,%p,%d,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, nCmdID,
1070         nCmdexecopt, pvaIn, pvaOut);
1071
1072   if (lpUnknown)
1073   {
1074     IOleCommandTarget* lpOle;
1075
1076     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
1077                                    (void**)&lpOle);
1078     if (SUCCEEDED(hRet) && lpOle)
1079     {
1080       hRet = IOleCommandTarget_Exec(lpOle, pguidCmdGroup, nCmdID,
1081                                     nCmdexecopt, pvaIn, pvaOut);
1082       IOleCommandTarget_Release(lpOle);
1083     }
1084   }
1085   return hRet;
1086 }
1087
1088 /*************************************************************************
1089  *      @       [SHLWAPI.165]
1090  *
1091  * Retrieve, modify, and re-set a value from a window.
1092  *
1093  * PARAMS
1094  *  hWnd   [I] Window to get value from
1095  *  offset [I] Offset of value
1096  *  mask   [I] Mask for flags
1097  *  flags  [I] Bits to set in window value
1098  *
1099  * RETURNS
1100  *  The new value as it was set, or 0 if any parameter is invalid.
1101  *
1102  * NOTES
1103  *  Only bits specified in mask are affected - set if present in flags and
1104  *  reset otherwise.
1105  */
1106 LONG WINAPI SHSetWindowBits(HWND hwnd, INT offset, UINT mask, UINT flags)
1107 {
1108   LONG ret = GetWindowLongW(hwnd, offset);
1109   LONG new_flags = (flags & mask) | (ret & ~mask);
1110
1111   TRACE("%p %d %x %x\n", hwnd, offset, mask, flags);
1112
1113   if (new_flags != ret)
1114     ret = SetWindowLongW(hwnd, offset, new_flags);
1115   return ret;
1116 }
1117
1118 /*************************************************************************
1119  *      @       [SHLWAPI.167]
1120  *
1121  * Change a window's parent.
1122  *
1123  * PARAMS
1124  *  hWnd       [I] Window to change parent of
1125  *  hWndParent [I] New parent window
1126  *
1127  * RETURNS
1128  *  The old parent of hWnd.
1129  *
1130  * NOTES
1131  *  If hWndParent is NULL (desktop), the window style is changed to WS_POPUP.
1132  *  If hWndParent is NOT NULL then we set the WS_CHILD style.
1133  */
1134 HWND WINAPI SHSetParentHwnd(HWND hWnd, HWND hWndParent)
1135 {
1136   TRACE("%p, %p\n", hWnd, hWndParent);
1137
1138   if(GetParent(hWnd) == hWndParent)
1139     return 0;
1140
1141   if(hWndParent)
1142     SHSetWindowBits(hWnd, GWL_STYLE, WS_CHILD, WS_CHILD);
1143   else
1144     SHSetWindowBits(hWnd, GWL_STYLE, WS_POPUP, WS_POPUP);
1145
1146   return SetParent(hWnd, hWndParent);
1147 }
1148
1149 /*************************************************************************
1150  *      @       [SHLWAPI.168]
1151  *
1152  * Locate and advise a connection point in an IConnectionPointContainer object.
1153  *
1154  * PARAMS
1155  *  lpUnkSink   [I] Sink for the connection point advise call
1156  *  riid        [I] REFIID of connection point to advise
1157  *  fConnect    [I] TRUE = Connection being establisted, FALSE = broken
1158  *  lpUnknown   [I] Object supporting the IConnectionPointContainer interface
1159  *  lpCookie    [O] Pointer to connection point cookie
1160  *  lppCP       [O] Destination for the IConnectionPoint found
1161  *
1162  * RETURNS
1163  *  Success: S_OK. If lppCP is non-NULL, it is filled with the IConnectionPoint
1164  *           that was advised. The caller is responsible for releasing it.
1165  *  Failure: E_FAIL, if any arguments are invalid.
1166  *           E_NOINTERFACE, if lpUnknown isn't an IConnectionPointContainer,
1167  *           Or an HRESULT error code if any call fails.
1168  */
1169 HRESULT WINAPI ConnectToConnectionPoint(IUnknown* lpUnkSink, REFIID riid, BOOL fConnect,
1170                            IUnknown* lpUnknown, LPDWORD lpCookie,
1171                            IConnectionPoint **lppCP)
1172 {
1173   HRESULT hRet;
1174   IConnectionPointContainer* lpContainer;
1175   IConnectionPoint *lpCP;
1176
1177   if(!lpUnknown || (fConnect && !lpUnkSink))
1178     return E_FAIL;
1179
1180   if(lppCP)
1181     *lppCP = NULL;
1182
1183   hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer,
1184                                  (void**)&lpContainer);
1185   if (SUCCEEDED(hRet))
1186   {
1187     hRet = IConnectionPointContainer_FindConnectionPoint(lpContainer, riid, &lpCP);
1188
1189     if (SUCCEEDED(hRet))
1190     {
1191       if(!fConnect)
1192         hRet = IConnectionPoint_Unadvise(lpCP, *lpCookie);
1193       else
1194         hRet = IConnectionPoint_Advise(lpCP, lpUnkSink, lpCookie);
1195
1196       if (FAILED(hRet))
1197         *lpCookie = 0;
1198
1199       if (lppCP && SUCCEEDED(hRet))
1200         *lppCP = lpCP; /* Caller keeps the interface */
1201       else
1202         IConnectionPoint_Release(lpCP); /* Release it */
1203     }
1204
1205     IUnknown_Release(lpContainer);
1206   }
1207   return hRet;
1208 }
1209
1210 /*************************************************************************
1211  *      @       [SHLWAPI.169]
1212  *
1213  * Release an interface and zero a supplied pointer.
1214  *
1215  * PARAMS
1216  *  lpUnknown [I] Object to release
1217  *
1218  * RETURNS
1219  *  Nothing.
1220  */
1221 void WINAPI IUnknown_AtomicRelease(IUnknown ** lpUnknown)
1222 {
1223     TRACE("(%p)\n", lpUnknown);
1224
1225     if(!lpUnknown || !*lpUnknown) return;
1226
1227     TRACE("doing Release\n");
1228
1229     IUnknown_Release(*lpUnknown);
1230     *lpUnknown = NULL;
1231 }
1232
1233 /*************************************************************************
1234  *      @       [SHLWAPI.170]
1235  *
1236  * Skip '//' if present in a string.
1237  *
1238  * PARAMS
1239  *  lpszSrc [I] String to check for '//'
1240  *
1241  * RETURNS
1242  *  Success: The next character after the '//' or the string if not present
1243  *  Failure: NULL, if lpszStr is NULL.
1244  */
1245 LPCSTR WINAPI PathSkipLeadingSlashesA(LPCSTR lpszSrc)
1246 {
1247   if (lpszSrc && lpszSrc[0] == '/' && lpszSrc[1] == '/')
1248     lpszSrc += 2;
1249   return lpszSrc;
1250 }
1251
1252 /*************************************************************************
1253  *      @               [SHLWAPI.171]
1254  *
1255  * Check if two interfaces come from the same object.
1256  *
1257  * PARAMS
1258  *   lpInt1 [I] Interface to check against lpInt2.
1259  *   lpInt2 [I] Interface to check against lpInt1.
1260  *
1261  * RETURNS
1262  *   TRUE, If the interfaces come from the same object.
1263  *   FALSE Otherwise.
1264  */
1265 BOOL WINAPI SHIsSameObject(IUnknown* lpInt1, IUnknown* lpInt2)
1266 {
1267   IUnknown *lpUnknown1, *lpUnknown2;
1268   BOOL ret;
1269
1270   TRACE("(%p %p)\n", lpInt1, lpInt2);
1271
1272   if (!lpInt1 || !lpInt2)
1273     return FALSE;
1274
1275   if (lpInt1 == lpInt2)
1276     return TRUE;
1277
1278   if (IUnknown_QueryInterface(lpInt1, &IID_IUnknown, (void**)&lpUnknown1) != S_OK)
1279     return FALSE;
1280
1281   if (IUnknown_QueryInterface(lpInt2, &IID_IUnknown, (void**)&lpUnknown2) != S_OK)
1282   {
1283     IUnknown_Release(lpUnknown1);
1284     return FALSE;
1285   }
1286
1287   ret = lpUnknown1 == lpUnknown2;
1288
1289   IUnknown_Release(lpUnknown1);
1290   IUnknown_Release(lpUnknown2);
1291
1292   return ret;
1293 }
1294
1295 /*************************************************************************
1296  *      @       [SHLWAPI.172]
1297  *
1298  * Get the window handle of an object.
1299  *
1300  * PARAMS
1301  *  lpUnknown [I] Object to get the window handle of
1302  *  lphWnd    [O] Destination for window handle
1303  *
1304  * RETURNS
1305  *  Success: S_OK. lphWnd contains the objects window handle.
1306  *  Failure: An HRESULT error code.
1307  *
1308  * NOTES
1309  *  lpUnknown is expected to support one of the following interfaces:
1310  *  IOleWindow(), IInternetSecurityMgrSite(), or IShellView().
1311  */
1312 HRESULT WINAPI IUnknown_GetWindow(IUnknown *lpUnknown, HWND *lphWnd)
1313 {
1314   IUnknown *lpOle;
1315   HRESULT hRet = E_FAIL;
1316
1317   TRACE("(%p,%p)\n", lpUnknown, lphWnd);
1318
1319   if (!lpUnknown)
1320     return hRet;
1321
1322   hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleWindow, (void**)&lpOle);
1323
1324   if (FAILED(hRet))
1325   {
1326     hRet = IUnknown_QueryInterface(lpUnknown,&IID_IShellView, (void**)&lpOle);
1327
1328     if (FAILED(hRet))
1329     {
1330       hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInternetSecurityMgrSite,
1331                                       (void**)&lpOle);
1332     }
1333   }
1334
1335   if (SUCCEEDED(hRet))
1336   {
1337     /* Lazyness here - Since GetWindow() is the first method for the above 3
1338      * interfaces, we use the same call for them all.
1339      */
1340     hRet = IOleWindow_GetWindow((IOleWindow*)lpOle, lphWnd);
1341     IUnknown_Release(lpOle);
1342     if (lphWnd)
1343       TRACE("Returning HWND=%p\n", *lphWnd);
1344   }
1345
1346   return hRet;
1347 }
1348
1349 /*************************************************************************
1350  *      @       [SHLWAPI.173]
1351  *
1352  * Call a SetOwner method of IShellService from specified object.
1353  *
1354  * PARAMS
1355  *  iface [I] Object that supports IShellService
1356  *  pUnk  [I] Argument for the SetOwner call
1357  *
1358  * RETURNS
1359  *  Corresponding return value from last call or E_FAIL for null input
1360  */
1361 HRESULT WINAPI IUnknown_SetOwner(IUnknown *iface, IUnknown *pUnk)
1362 {
1363   IShellService *service;
1364   HRESULT hr;
1365
1366   TRACE("(%p, %p)\n", iface, pUnk);
1367
1368   if (!iface) return E_FAIL;
1369
1370   hr = IUnknown_QueryInterface(iface, &IID_IShellService, (void**)&service);
1371   if (hr == S_OK)
1372   {
1373     hr = IShellService_SetOwner(service, pUnk);
1374     IShellService_Release(service);
1375   }
1376
1377   return hr;
1378 }
1379
1380 /*************************************************************************
1381  *      @       [SHLWAPI.174]
1382  *
1383  * Call either IObjectWithSite_SetSite() or IInternetSecurityManager_SetSecuritySite() on
1384  * an object.
1385  *
1386  */
1387 HRESULT WINAPI IUnknown_SetSite(
1388         IUnknown *obj,        /* [in]   OLE object     */
1389         IUnknown *site)       /* [in]   Site interface */
1390 {
1391     HRESULT hr;
1392     IObjectWithSite *iobjwithsite;
1393     IInternetSecurityManager *isecmgr;
1394
1395     if (!obj) return E_FAIL;
1396
1397     hr = IUnknown_QueryInterface(obj, &IID_IObjectWithSite, (LPVOID *)&iobjwithsite);
1398     TRACE("IID_IObjectWithSite QI ret=%08x, %p\n", hr, iobjwithsite);
1399     if (SUCCEEDED(hr))
1400     {
1401         hr = IObjectWithSite_SetSite(iobjwithsite, site);
1402         TRACE("done IObjectWithSite_SetSite ret=%08x\n", hr);
1403         IUnknown_Release(iobjwithsite);
1404     }
1405     else
1406     {
1407         hr = IUnknown_QueryInterface(obj, &IID_IInternetSecurityManager, (LPVOID *)&isecmgr);
1408         TRACE("IID_IInternetSecurityManager QI ret=%08x, %p\n", hr, isecmgr);
1409         if (FAILED(hr)) return hr;
1410
1411         hr = IInternetSecurityManager_SetSecuritySite(isecmgr, (IInternetSecurityMgrSite *)site);
1412         TRACE("done IInternetSecurityManager_SetSecuritySite ret=%08x\n", hr);
1413         IUnknown_Release(isecmgr);
1414     }
1415     return hr;
1416 }
1417
1418 /*************************************************************************
1419  *      @       [SHLWAPI.175]
1420  *
1421  * Call IPersist_GetClassID() on an object.
1422  *
1423  * PARAMS
1424  *  lpUnknown [I] Object supporting the IPersist interface
1425  *  lpClassId [O] Destination for Class Id
1426  *
1427  * RETURNS
1428  *  Success: S_OK. lpClassId contains the Class Id requested.
1429  *  Failure: E_FAIL, If lpUnknown is NULL,
1430  *           E_NOINTERFACE If lpUnknown does not support IPersist,
1431  *           Or an HRESULT error code.
1432  */
1433 HRESULT WINAPI IUnknown_GetClassID(IUnknown *lpUnknown, CLSID* lpClassId)
1434 {
1435   IPersist* lpPersist;
1436   HRESULT hRet = E_FAIL;
1437
1438   TRACE("(%p,%p)\n", lpUnknown, debugstr_guid(lpClassId));
1439
1440   if (lpUnknown)
1441   {
1442     hRet = IUnknown_QueryInterface(lpUnknown,&IID_IPersist,(void**)&lpPersist);
1443     if (SUCCEEDED(hRet))
1444     {
1445       IPersist_GetClassID(lpPersist, lpClassId);
1446       IPersist_Release(lpPersist);
1447     }
1448   }
1449   return hRet;
1450 }
1451
1452 /*************************************************************************
1453  *      @       [SHLWAPI.176]
1454  *
1455  * Retrieve a Service Interface from an object.
1456  *
1457  * PARAMS
1458  *  lpUnknown [I] Object to get an IServiceProvider interface from
1459  *  sid       [I] Service ID for IServiceProvider_QueryService() call
1460  *  riid      [I] Function requested for QueryService call
1461  *  lppOut    [O] Destination for the service interface pointer
1462  *
1463  * RETURNS
1464  *  Success: S_OK. lppOut contains an object providing the requested service
1465  *  Failure: An HRESULT error code
1466  *
1467  * NOTES
1468  *  lpUnknown is expected to support the IServiceProvider interface.
1469  */
1470 HRESULT WINAPI IUnknown_QueryService(IUnknown* lpUnknown, REFGUID sid, REFIID riid,
1471                            LPVOID *lppOut)
1472 {
1473   IServiceProvider* pService = NULL;
1474   HRESULT hRet;
1475
1476   if (!lppOut)
1477     return E_FAIL;
1478
1479   *lppOut = NULL;
1480
1481   if (!lpUnknown)
1482     return E_FAIL;
1483
1484   hRet = IUnknown_QueryInterface(lpUnknown, &IID_IServiceProvider,
1485                                  (LPVOID*)&pService);
1486
1487   if (hRet == S_OK && pService)
1488   {
1489     TRACE("QueryInterface returned (IServiceProvider*)%p\n", pService);
1490
1491     /* Get a Service interface from the object */
1492     hRet = IServiceProvider_QueryService(pService, sid, riid, lppOut);
1493
1494     TRACE("(IServiceProvider*)%p returned (IUnknown*)%p\n", pService, *lppOut);
1495
1496     IUnknown_Release(pService);
1497   }
1498   return hRet;
1499 }
1500
1501 /*************************************************************************
1502  *      @       [SHLWAPI.484]
1503  *
1504  * Calls IOleCommandTarget::Exec() for specified service object.
1505  *
1506  * PARAMS
1507  *  lpUnknown [I] Object to get an IServiceProvider interface from
1508  *  service   [I] Service ID for IServiceProvider_QueryService() call
1509  *  group     [I] Group ID for IOleCommandTarget::Exec() call
1510  *  cmdId     [I] Command ID for IOleCommandTarget::Exec() call
1511  *  cmdOpt    [I] Options flags for command
1512  *  pIn       [I] Input arguments for command
1513  *  pOut      [O] Output arguments for command
1514  *
1515  * RETURNS
1516  *  Success: S_OK. lppOut contains an object providing the requested service
1517  *  Failure: An HRESULT error code
1518  *
1519  * NOTES
1520  *  lpUnknown is expected to support the IServiceProvider interface.
1521  */
1522 HRESULT WINAPI IUnknown_QueryServiceExec(IUnknown *lpUnknown, REFIID service,
1523     const GUID *group, DWORD cmdId, DWORD cmdOpt, VARIANT *pIn, VARIANT *pOut)
1524 {
1525     IOleCommandTarget *target;
1526     HRESULT hr;
1527
1528     TRACE("%p %s %s %d %08x %p %p\n", lpUnknown, debugstr_guid(service),
1529         debugstr_guid(group), cmdId, cmdOpt, pIn, pOut);
1530
1531     hr = IUnknown_QueryService(lpUnknown, service, &IID_IOleCommandTarget, (void**)&target);
1532     if (hr == S_OK)
1533     {
1534         hr = IOleCommandTarget_Exec(target, group, cmdId, cmdOpt, pIn, pOut);
1535         IOleCommandTarget_Release(target);
1536     }
1537
1538     TRACE("<-- hr=0x%08x\n", hr);
1539
1540     return hr;
1541 }
1542
1543 /*************************************************************************
1544  *      @       [SHLWAPI.514]
1545  *
1546  * Calls IProfferService methods to proffer/revoke specified service.
1547  *
1548  * PARAMS
1549  *  lpUnknown [I]  Object to get an IServiceProvider interface from
1550  *  service   [I]  Service ID for IProfferService::Proffer/Revoke calls
1551  *  pService  [I]  Service to proffer. If NULL ::Revoke is called
1552  *  pCookie   [IO] Group ID for IOleCommandTarget::Exec() call
1553  *
1554  * RETURNS
1555  *  Success: S_OK. IProffer method returns S_OK
1556  *  Failure: An HRESULT error code
1557  *
1558  * NOTES
1559  *  lpUnknown is expected to support the IServiceProvider interface.
1560  */
1561 HRESULT WINAPI IUnknown_ProfferService(IUnknown *lpUnknown, REFGUID service, IServiceProvider *pService, DWORD *pCookie)
1562 {
1563     IProfferService *proffer;
1564     HRESULT hr;
1565
1566     TRACE("%p %s %p %p\n", lpUnknown, debugstr_guid(service), pService, pCookie);
1567
1568     hr = IUnknown_QueryService(lpUnknown, &IID_IProfferService, &IID_IProfferService, (void**)&proffer);
1569     if (hr == S_OK)
1570     {
1571         if (pService)
1572             hr = IProfferService_ProfferService(proffer, service, pService, pCookie);
1573         else
1574         {
1575             hr = IProfferService_RevokeService(proffer, *pCookie);
1576             *pCookie = 0;
1577         }
1578
1579         IProfferService_Release(proffer);
1580     }
1581
1582     return hr;
1583 }
1584
1585 /*************************************************************************
1586  *      @       [SHLWAPI.479]
1587  *
1588  * Call an object's UIActivateIO method.
1589  *
1590  * PARAMS
1591  *  unknown  [I] Object to call the UIActivateIO method on
1592  *  activate [I] Parameter for UIActivateIO call
1593  *  msg      [I] Parameter for UIActivateIO call
1594  *
1595  * RETURNS
1596  *  Success: Value of UI_ActivateIO call
1597  *  Failure: An HRESULT error code
1598  *
1599  * NOTES
1600  *  unknown is expected to support the IInputObject interface.
1601  */
1602 HRESULT WINAPI IUnknown_UIActivateIO(IUnknown *unknown, BOOL activate, LPMSG msg)
1603 {
1604     IInputObject* object = NULL;
1605     HRESULT ret;
1606
1607     if (!unknown)
1608         return E_FAIL;
1609
1610     /* Get an IInputObject interface from the object */
1611     ret = IUnknown_QueryInterface(unknown, &IID_IInputObject, (LPVOID*) &object);
1612
1613     if (ret == S_OK)
1614     {
1615         ret = IInputObject_UIActivateIO(object, activate, msg);
1616         IUnknown_Release(object);
1617     }
1618
1619     return ret;
1620 }
1621
1622 /*************************************************************************
1623  *      @       [SHLWAPI.177]
1624  *
1625  * Loads a popup menu.
1626  *
1627  * PARAMS
1628  *  hInst  [I] Instance handle
1629  *  szName [I] Menu name
1630  *
1631  * RETURNS
1632  *  Success: TRUE.
1633  *  Failure: FALSE.
1634  */
1635 BOOL WINAPI SHLoadMenuPopup(HINSTANCE hInst, LPCWSTR szName)
1636 {
1637   HMENU hMenu;
1638
1639   TRACE("%p %s\n", hInst, debugstr_w(szName));
1640
1641   if ((hMenu = LoadMenuW(hInst, szName)))
1642   {
1643     if (GetSubMenu(hMenu, 0))
1644       RemoveMenu(hMenu, 0, MF_BYPOSITION);
1645
1646     DestroyMenu(hMenu);
1647     return TRUE;
1648   }
1649   return FALSE;
1650 }
1651
1652 typedef struct _enumWndData
1653 {
1654   UINT   uiMsgId;
1655   WPARAM wParam;
1656   LPARAM lParam;
1657   LRESULT (WINAPI *pfnPost)(HWND,UINT,WPARAM,LPARAM);
1658 } enumWndData;
1659
1660 /* Callback for SHLWAPI_178 */
1661 static BOOL CALLBACK SHLWAPI_EnumChildProc(HWND hWnd, LPARAM lParam)
1662 {
1663   enumWndData *data = (enumWndData *)lParam;
1664
1665   TRACE("(%p,%p)\n", hWnd, data);
1666   data->pfnPost(hWnd, data->uiMsgId, data->wParam, data->lParam);
1667   return TRUE;
1668 }
1669
1670 /*************************************************************************
1671  * @  [SHLWAPI.178]
1672  *
1673  * Send or post a message to every child of a window.
1674  *
1675  * PARAMS
1676  *  hWnd    [I] Window whose children will get the messages
1677  *  uiMsgId [I] Message Id
1678  *  wParam  [I] WPARAM of message
1679  *  lParam  [I] LPARAM of message
1680  *  bSend   [I] TRUE = Use SendMessageA(), FALSE = Use PostMessageA()
1681  *
1682  * RETURNS
1683  *  Nothing.
1684  *
1685  * NOTES
1686  *  The appropriate ASCII or Unicode function is called for the window.
1687  */
1688 void WINAPI SHPropagateMessage(HWND hWnd, UINT uiMsgId, WPARAM wParam, LPARAM lParam, BOOL bSend)
1689 {
1690   enumWndData data;
1691
1692   TRACE("(%p,%u,%ld,%ld,%d)\n", hWnd, uiMsgId, wParam, lParam, bSend);
1693
1694   if(hWnd)
1695   {
1696     data.uiMsgId = uiMsgId;
1697     data.wParam  = wParam;
1698     data.lParam  = lParam;
1699
1700     if (bSend)
1701       data.pfnPost = IsWindowUnicode(hWnd) ? (void*)SendMessageW : (void*)SendMessageA;
1702     else
1703       data.pfnPost = IsWindowUnicode(hWnd) ? (void*)PostMessageW : (void*)PostMessageA;
1704
1705     EnumChildWindows(hWnd, SHLWAPI_EnumChildProc, (LPARAM)&data);
1706   }
1707 }
1708
1709 /*************************************************************************
1710  *      @       [SHLWAPI.180]
1711  *
1712  * Remove all sub-menus from a menu.
1713  *
1714  * PARAMS
1715  *  hMenu [I] Menu to remove sub-menus from
1716  *
1717  * RETURNS
1718  *  Success: 0.  All sub-menus under hMenu are removed
1719  *  Failure: -1, if any parameter is invalid
1720  */
1721 DWORD WINAPI SHRemoveAllSubMenus(HMENU hMenu)
1722 {
1723   int iItemCount = GetMenuItemCount(hMenu) - 1;
1724
1725   TRACE("%p\n", hMenu);
1726
1727   while (iItemCount >= 0)
1728   {
1729     HMENU hSubMenu = GetSubMenu(hMenu, iItemCount);
1730     if (hSubMenu)
1731       RemoveMenu(hMenu, iItemCount, MF_BYPOSITION);
1732     iItemCount--;
1733   }
1734   return iItemCount;
1735 }
1736
1737 /*************************************************************************
1738  *      @       [SHLWAPI.181]
1739  *
1740  * Enable or disable a menu item.
1741  *
1742  * PARAMS
1743  *  hMenu   [I] Menu holding menu item
1744  *  uID     [I] ID of menu item to enable/disable
1745  *  bEnable [I] Whether to enable (TRUE) or disable (FALSE) the item.
1746  *
1747  * RETURNS
1748  *  The return code from EnableMenuItem.
1749  */
1750 UINT WINAPI SHEnableMenuItem(HMENU hMenu, UINT wItemID, BOOL bEnable)
1751 {
1752   TRACE("%p, %u, %d\n", hMenu, wItemID, bEnable);
1753   return EnableMenuItem(hMenu, wItemID, bEnable ? MF_ENABLED : MF_GRAYED);
1754 }
1755
1756 /*************************************************************************
1757  * @    [SHLWAPI.182]
1758  *
1759  * Check or uncheck a menu item.
1760  *
1761  * PARAMS
1762  *  hMenu  [I] Menu holding menu item
1763  *  uID    [I] ID of menu item to check/uncheck
1764  *  bCheck [I] Whether to check (TRUE) or uncheck (FALSE) the item.
1765  *
1766  * RETURNS
1767  *  The return code from CheckMenuItem.
1768  */
1769 DWORD WINAPI SHCheckMenuItem(HMENU hMenu, UINT uID, BOOL bCheck)
1770 {
1771   TRACE("%p, %u, %d\n", hMenu, uID, bCheck);
1772   return CheckMenuItem(hMenu, uID, bCheck ? MF_CHECKED : MF_UNCHECKED);
1773 }
1774
1775 /*************************************************************************
1776  *      @       [SHLWAPI.183]
1777  *
1778  * Register a window class if it isn't already.
1779  *
1780  * PARAMS
1781  *  lpWndClass [I] Window class to register
1782  *
1783  * RETURNS
1784  *  The result of the RegisterClassA call.
1785  */
1786 DWORD WINAPI SHRegisterClassA(WNDCLASSA *wndclass)
1787 {
1788   WNDCLASSA wca;
1789   if (GetClassInfoA(wndclass->hInstance, wndclass->lpszClassName, &wca))
1790     return TRUE;
1791   return (DWORD)RegisterClassA(wndclass);
1792 }
1793
1794 /*************************************************************************
1795  *      @       [SHLWAPI.186]
1796  */
1797 BOOL WINAPI SHSimulateDrop(IDropTarget *pDrop, IDataObject *pDataObj,
1798                            DWORD grfKeyState, PPOINTL lpPt, DWORD* pdwEffect)
1799 {
1800   DWORD dwEffect = DROPEFFECT_LINK | DROPEFFECT_MOVE | DROPEFFECT_COPY;
1801   POINTL pt = { 0, 0 };
1802
1803   TRACE("%p %p 0x%08x %p %p\n", pDrop, pDataObj, grfKeyState, lpPt, pdwEffect);
1804
1805   if (!lpPt)
1806     lpPt = &pt;
1807
1808   if (!pdwEffect)
1809     pdwEffect = &dwEffect;
1810
1811   IDropTarget_DragEnter(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1812
1813   if (*pdwEffect != DROPEFFECT_NONE)
1814     return IDropTarget_Drop(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1815
1816   IDropTarget_DragLeave(pDrop);
1817   return TRUE;
1818 }
1819
1820 /*************************************************************************
1821  *      @       [SHLWAPI.187]
1822  *
1823  * Call IPersistPropertyBag_Load() on an object.
1824  *
1825  * PARAMS
1826  *  lpUnknown [I] Object supporting the IPersistPropertyBag interface
1827  *  lpPropBag [O] Destination for loaded IPropertyBag
1828  *
1829  * RETURNS
1830  *  Success: S_OK.
1831  *  Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1832  */
1833 DWORD WINAPI SHLoadFromPropertyBag(IUnknown *lpUnknown, IPropertyBag* lpPropBag)
1834 {
1835   IPersistPropertyBag* lpPPBag;
1836   HRESULT hRet = E_FAIL;
1837
1838   TRACE("(%p,%p)\n", lpUnknown, lpPropBag);
1839
1840   if (lpUnknown)
1841   {
1842     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IPersistPropertyBag,
1843                                    (void**)&lpPPBag);
1844     if (SUCCEEDED(hRet) && lpPPBag)
1845     {
1846       hRet = IPersistPropertyBag_Load(lpPPBag, lpPropBag, NULL);
1847       IPersistPropertyBag_Release(lpPPBag);
1848     }
1849   }
1850   return hRet;
1851 }
1852
1853 /*************************************************************************
1854  * @  [SHLWAPI.188]
1855  *
1856  * Call IOleControlSite_TranslateAccelerator()  on an object.
1857  *
1858  * PARAMS
1859  *  lpUnknown   [I] Object supporting the IOleControlSite interface.
1860  *  lpMsg       [I] Key message to be processed.
1861  *  dwModifiers [I] Flags containing the state of the modifier keys.
1862  *
1863  * RETURNS
1864  *  Success: S_OK.
1865  *  Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
1866  */
1867 HRESULT WINAPI IUnknown_TranslateAcceleratorOCS(IUnknown *lpUnknown, LPMSG lpMsg, DWORD dwModifiers)
1868 {
1869   IOleControlSite* lpCSite = NULL;
1870   HRESULT hRet = E_INVALIDARG;
1871
1872   TRACE("(%p,%p,0x%08x)\n", lpUnknown, lpMsg, dwModifiers);
1873   if (lpUnknown)
1874   {
1875     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1876                                    (void**)&lpCSite);
1877     if (SUCCEEDED(hRet) && lpCSite)
1878     {
1879       hRet = IOleControlSite_TranslateAccelerator(lpCSite, lpMsg, dwModifiers);
1880       IOleControlSite_Release(lpCSite);
1881     }
1882   }
1883   return hRet;
1884 }
1885
1886
1887 /*************************************************************************
1888  * @  [SHLWAPI.189]
1889  *
1890  * Call IOleControlSite_OnFocus() on an object.
1891  *
1892  * PARAMS
1893  *  lpUnknown [I] Object supporting the IOleControlSite interface.
1894  *  fGotFocus [I] Whether focus was gained (TRUE) or lost (FALSE).
1895  *
1896  * RETURNS
1897  *  Success: S_OK.
1898  *  Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1899  */
1900 HRESULT WINAPI IUnknown_OnFocusOCS(IUnknown *lpUnknown, BOOL fGotFocus)
1901 {
1902   IOleControlSite* lpCSite = NULL;
1903   HRESULT hRet = E_FAIL;
1904
1905   TRACE("(%p, %d)\n", lpUnknown, fGotFocus);
1906   if (lpUnknown)
1907   {
1908     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1909                                    (void**)&lpCSite);
1910     if (SUCCEEDED(hRet) && lpCSite)
1911     {
1912       hRet = IOleControlSite_OnFocus(lpCSite, fGotFocus);
1913       IOleControlSite_Release(lpCSite);
1914     }
1915   }
1916   return hRet;
1917 }
1918
1919 /*************************************************************************
1920  * @    [SHLWAPI.190]
1921  */
1922 HRESULT WINAPI IUnknown_HandleIRestrict(LPUNKNOWN lpUnknown, PVOID lpArg1,
1923                                         PVOID lpArg2, PVOID lpArg3, PVOID lpArg4)
1924 {
1925   /* FIXME: {D12F26B2-D90A-11D0-830D-00AA005B4383} - What object does this represent? */
1926   static const DWORD service_id[] = { 0xd12f26b2, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1927   /* FIXME: {D12F26B1-D90A-11D0-830D-00AA005B4383} - Also Unknown/undocumented */
1928   static const DWORD function_id[] = { 0xd12f26b1, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1929   HRESULT hRet = E_INVALIDARG;
1930   LPUNKNOWN lpUnkInner = NULL; /* FIXME: Real type is unknown */
1931
1932   TRACE("(%p,%p,%p,%p,%p)\n", lpUnknown, lpArg1, lpArg2, lpArg3, lpArg4);
1933
1934   if (lpUnknown && lpArg4)
1935   {
1936      hRet = IUnknown_QueryService(lpUnknown, (REFGUID)service_id,
1937                                   (REFGUID)function_id, (void**)&lpUnkInner);
1938
1939      if (SUCCEEDED(hRet) && lpUnkInner)
1940      {
1941        /* FIXME: The type of service object requested is unknown, however
1942         * testing shows that its first method is called with 4 parameters.
1943         * Fake this by using IParseDisplayName_ParseDisplayName since the
1944         * signature and position in the vtable matches our unknown object type.
1945         */
1946        hRet = IParseDisplayName_ParseDisplayName((LPPARSEDISPLAYNAME)lpUnkInner,
1947                                                  lpArg1, lpArg2, lpArg3, lpArg4);
1948        IUnknown_Release(lpUnkInner);
1949      }
1950   }
1951   return hRet;
1952 }
1953
1954 /*************************************************************************
1955  * @    [SHLWAPI.192]
1956  *
1957  * Get a sub-menu from a menu item.
1958  *
1959  * PARAMS
1960  *  hMenu [I] Menu to get sub-menu from
1961  *  uID   [I] ID of menu item containing sub-menu
1962  *
1963  * RETURNS
1964  *  The sub-menu of the item, or a NULL handle if any parameters are invalid.
1965  */
1966 HMENU WINAPI SHGetMenuFromID(HMENU hMenu, UINT uID)
1967 {
1968   MENUITEMINFOW mi;
1969
1970   TRACE("(%p,%u)\n", hMenu, uID);
1971
1972   mi.cbSize = sizeof(mi);
1973   mi.fMask = MIIM_SUBMENU;
1974
1975   if (!GetMenuItemInfoW(hMenu, uID, FALSE, &mi))
1976     return NULL;
1977
1978   return mi.hSubMenu;
1979 }
1980
1981 /*************************************************************************
1982  *      @       [SHLWAPI.193]
1983  *
1984  * Get the color depth of the primary display.
1985  *
1986  * PARAMS
1987  *  None.
1988  *
1989  * RETURNS
1990  *  The color depth of the primary display.
1991  */
1992 DWORD WINAPI SHGetCurColorRes(void)
1993 {
1994     HDC hdc;
1995     DWORD ret;
1996
1997     TRACE("()\n");
1998
1999     hdc = GetDC(0);
2000     ret = GetDeviceCaps(hdc, BITSPIXEL) * GetDeviceCaps(hdc, PLANES);
2001     ReleaseDC(0, hdc);
2002     return ret;
2003 }
2004
2005 /*************************************************************************
2006  *      @       [SHLWAPI.194]
2007  *
2008  * Wait for a message to arrive, with a timeout.
2009  *
2010  * PARAMS
2011  *  hand      [I] Handle to query
2012  *  dwTimeout [I] Timeout in ticks or INFINITE to never timeout
2013  *
2014  * RETURNS
2015  *  STATUS_TIMEOUT if no message is received before dwTimeout ticks passes.
2016  *  Otherwise returns the value from MsgWaitForMultipleObjectsEx when a
2017  *  message is available.
2018  */
2019 DWORD WINAPI SHWaitForSendMessageThread(HANDLE hand, DWORD dwTimeout)
2020 {
2021   DWORD dwEndTicks = GetTickCount() + dwTimeout;
2022   DWORD dwRet;
2023
2024   while ((dwRet = MsgWaitForMultipleObjectsEx(1, &hand, dwTimeout, QS_SENDMESSAGE, 0)) == 1)
2025   {
2026     MSG msg;
2027
2028     PeekMessageW(&msg, NULL, 0, 0, PM_NOREMOVE);
2029
2030     if (dwTimeout != INFINITE)
2031     {
2032         if ((int)(dwTimeout = dwEndTicks - GetTickCount()) <= 0)
2033             return WAIT_TIMEOUT;
2034     }
2035   }
2036
2037   return dwRet;
2038 }
2039
2040 /*************************************************************************
2041  *      @       [SHLWAPI.195]
2042  *
2043  * Determine if a shell folder can be expanded.
2044  *
2045  * PARAMS
2046  *  lpFolder [I] Parent folder containing the object to test.
2047  *  pidl     [I] Id of the object to test.
2048  *
2049  * RETURNS
2050  *  Success: S_OK, if the object is expandable, S_FALSE otherwise.
2051  *  Failure: E_INVALIDARG, if any argument is invalid.
2052  *
2053  * NOTES
2054  *  If the object to be tested does not expose the IQueryInfo() interface it
2055  *  will not be identified as an expandable folder.
2056  */
2057 HRESULT WINAPI SHIsExpandableFolder(LPSHELLFOLDER lpFolder, LPCITEMIDLIST pidl)
2058 {
2059   HRESULT hRet = E_INVALIDARG;
2060   IQueryInfo *lpInfo;
2061
2062   if (lpFolder && pidl)
2063   {
2064     hRet = IShellFolder_GetUIObjectOf(lpFolder, NULL, 1, &pidl, &IID_IQueryInfo,
2065                                       NULL, (void**)&lpInfo);
2066     if (FAILED(hRet))
2067       hRet = S_FALSE; /* Doesn't expose IQueryInfo */
2068     else
2069     {
2070       DWORD dwFlags = 0;
2071
2072       /* MSDN states of IQueryInfo_GetInfoFlags() that "This method is not
2073        * currently used". Really? You wouldn't be holding out on me would you?
2074        */
2075       hRet = IQueryInfo_GetInfoFlags(lpInfo, &dwFlags);
2076
2077       if (SUCCEEDED(hRet))
2078       {
2079         /* 0x2 is an undocumented flag apparently indicating expandability */
2080         hRet = dwFlags & 0x2 ? S_OK : S_FALSE;
2081       }
2082
2083       IQueryInfo_Release(lpInfo);
2084     }
2085   }
2086   return hRet;
2087 }
2088
2089 /*************************************************************************
2090  *      @       [SHLWAPI.197]
2091  *
2092  * Blank out a region of text by drawing the background only.
2093  *
2094  * PARAMS
2095  *  hDC   [I] Device context to draw in
2096  *  pRect [I] Area to draw in
2097  *  cRef  [I] Color to draw in
2098  *
2099  * RETURNS
2100  *  Nothing.
2101  */
2102 DWORD WINAPI SHFillRectClr(HDC hDC, LPCRECT pRect, COLORREF cRef)
2103 {
2104     COLORREF cOldColor = SetBkColor(hDC, cRef);
2105     ExtTextOutA(hDC, 0, 0, ETO_OPAQUE, pRect, 0, 0, 0);
2106     SetBkColor(hDC, cOldColor);
2107     return 0;
2108 }
2109
2110 /*************************************************************************
2111  *      @       [SHLWAPI.198]
2112  *
2113  * Return the value associated with a key in a map.
2114  *
2115  * PARAMS
2116  *  lpKeys   [I] A list of keys of length iLen
2117  *  lpValues [I] A list of values associated with lpKeys, of length iLen
2118  *  iLen     [I] Length of both lpKeys and lpValues
2119  *  iKey     [I] The key value to look up in lpKeys
2120  *
2121  * RETURNS
2122  *  The value in lpValues associated with iKey, or -1 if iKey is not
2123  *  found in lpKeys.
2124  *
2125  * NOTES
2126  *  - If two elements in the map share the same key, this function returns
2127  *    the value closest to the start of the map
2128  *  - The native version of this function crashes if lpKeys or lpValues is NULL.
2129  */
2130 int WINAPI SHSearchMapInt(const int *lpKeys, const int *lpValues, int iLen, int iKey)
2131 {
2132   if (lpKeys && lpValues)
2133   {
2134     int i = 0;
2135
2136     while (i < iLen)
2137     {
2138       if (lpKeys[i] == iKey)
2139         return lpValues[i]; /* Found */
2140       i++;
2141     }
2142   }
2143   return -1; /* Not found */
2144 }
2145
2146
2147 /*************************************************************************
2148  *      @       [SHLWAPI.199]
2149  *
2150  * Copy an interface pointer
2151  *
2152  * PARAMS
2153  *   lppDest   [O] Destination for copy
2154  *   lpUnknown [I] Source for copy
2155  *
2156  * RETURNS
2157  *  Nothing.
2158  */
2159 VOID WINAPI IUnknown_Set(IUnknown **lppDest, IUnknown *lpUnknown)
2160 {
2161   TRACE("(%p,%p)\n", lppDest, lpUnknown);
2162
2163   IUnknown_AtomicRelease(lppDest);
2164
2165   if (lpUnknown)
2166   {
2167     IUnknown_AddRef(lpUnknown);
2168     *lppDest = lpUnknown;
2169   }
2170 }
2171
2172 /*************************************************************************
2173  *      @       [SHLWAPI.200]
2174  *
2175  */
2176 HRESULT WINAPI MayQSForward(IUnknown* lpUnknown, PVOID lpReserved,
2177                             REFGUID riidCmdGrp, ULONG cCmds,
2178                             OLECMD *prgCmds, OLECMDTEXT* pCmdText)
2179 {
2180   FIXME("(%p,%p,%p,%d,%p,%p) - stub\n",
2181         lpUnknown, lpReserved, riidCmdGrp, cCmds, prgCmds, pCmdText);
2182
2183   /* FIXME: Calls IsQSForward & IUnknown_QueryStatus */
2184   return DRAGDROP_E_NOTREGISTERED;
2185 }
2186
2187 /*************************************************************************
2188  *      @       [SHLWAPI.201]
2189  *
2190  */
2191 HRESULT WINAPI MayExecForward(IUnknown* lpUnknown, INT iUnk, REFGUID pguidCmdGroup,
2192                            DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
2193                            VARIANT* pvaOut)
2194 {
2195   FIXME("(%p,%d,%p,%d,%d,%p,%p) - stub!\n", lpUnknown, iUnk, pguidCmdGroup,
2196         nCmdID, nCmdexecopt, pvaIn, pvaOut);
2197   return DRAGDROP_E_NOTREGISTERED;
2198 }
2199
2200 /*************************************************************************
2201  *      @       [SHLWAPI.202]
2202  *
2203  */
2204 HRESULT WINAPI IsQSForward(REFGUID pguidCmdGroup,ULONG cCmds, OLECMD *prgCmds)
2205 {
2206   FIXME("(%p,%d,%p) - stub!\n", pguidCmdGroup, cCmds, prgCmds);
2207   return DRAGDROP_E_NOTREGISTERED;
2208 }
2209
2210 /*************************************************************************
2211  * @    [SHLWAPI.204]
2212  *
2213  * Determine if a window is not a child of another window.
2214  *
2215  * PARAMS
2216  * hParent [I] Suspected parent window
2217  * hChild  [I] Suspected child window
2218  *
2219  * RETURNS
2220  * TRUE:  If hChild is a child window of hParent
2221  * FALSE: If hChild is not a child window of hParent, or they are equal
2222  */
2223 BOOL WINAPI SHIsChildOrSelf(HWND hParent, HWND hChild)
2224 {
2225   TRACE("(%p,%p)\n", hParent, hChild);
2226
2227   if (!hParent || !hChild)
2228     return TRUE;
2229   else if(hParent == hChild)
2230     return FALSE;
2231   return !IsChild(hParent, hChild);
2232 }
2233
2234 /*************************************************************************
2235  *    FDSA functions.  Manage a dynamic array of fixed size memory blocks.
2236  */
2237
2238 typedef struct
2239 {
2240     DWORD num_items;       /* Number of elements inserted */
2241     void *mem;             /* Ptr to array */
2242     DWORD blocks_alloced;  /* Number of elements allocated */
2243     BYTE inc;              /* Number of elements to grow by when we need to expand */
2244     BYTE block_size;       /* Size in bytes of an element */
2245     BYTE flags;            /* Flags */
2246 } FDSA_info;
2247
2248 #define FDSA_FLAG_INTERNAL_ALLOC 0x01 /* When set we have allocated mem internally */
2249
2250 /*************************************************************************
2251  *      @       [SHLWAPI.208]
2252  *
2253  * Initialize an FDSA array.
2254  */
2255 BOOL WINAPI FDSA_Initialize(DWORD block_size, DWORD inc, FDSA_info *info, void *mem,
2256                             DWORD init_blocks)
2257 {
2258     TRACE("(0x%08x 0x%08x %p %p 0x%08x)\n", block_size, inc, info, mem, init_blocks);
2259
2260     if(inc == 0)
2261         inc = 1;
2262
2263     if(mem)
2264         memset(mem, 0, block_size * init_blocks);
2265     
2266     info->num_items = 0;
2267     info->inc = inc;
2268     info->mem = mem;
2269     info->blocks_alloced = init_blocks;
2270     info->block_size = block_size;
2271     info->flags = 0;
2272
2273     return TRUE;
2274 }
2275
2276 /*************************************************************************
2277  *      @       [SHLWAPI.209]
2278  *
2279  * Destroy an FDSA array
2280  */
2281 BOOL WINAPI FDSA_Destroy(FDSA_info *info)
2282 {
2283     TRACE("(%p)\n", info);
2284
2285     if(info->flags & FDSA_FLAG_INTERNAL_ALLOC)
2286     {
2287         HeapFree(GetProcessHeap(), 0, info->mem);
2288         return FALSE;
2289     }
2290
2291     return TRUE;
2292 }
2293
2294 /*************************************************************************
2295  *      @       [SHLWAPI.210]
2296  *
2297  * Insert element into an FDSA array
2298  */
2299 DWORD WINAPI FDSA_InsertItem(FDSA_info *info, DWORD where, const void *block)
2300 {
2301     TRACE("(%p 0x%08x %p)\n", info, where, block);
2302     if(where > info->num_items)
2303         where = info->num_items;
2304
2305     if(info->num_items >= info->blocks_alloced)
2306     {
2307         DWORD size = (info->blocks_alloced + info->inc) * info->block_size;
2308         if(info->flags & 0x1)
2309             info->mem = HeapReAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, info->mem, size);
2310         else
2311         {
2312             void *old_mem = info->mem;
2313             info->mem = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, size);
2314             memcpy(info->mem, old_mem, info->blocks_alloced * info->block_size);
2315         }
2316         info->blocks_alloced += info->inc;
2317         info->flags |= 0x1;
2318     }
2319
2320     if(where < info->num_items)
2321     {
2322         memmove((char*)info->mem + (where + 1) * info->block_size,
2323                 (char*)info->mem + where * info->block_size,
2324                 (info->num_items - where) * info->block_size);
2325     }
2326     memcpy((char*)info->mem + where * info->block_size, block, info->block_size);
2327
2328     info->num_items++;
2329     return where;
2330 }
2331
2332 /*************************************************************************
2333  *      @       [SHLWAPI.211]
2334  *
2335  * Delete an element from an FDSA array.
2336  */
2337 BOOL WINAPI FDSA_DeleteItem(FDSA_info *info, DWORD where)
2338 {
2339     TRACE("(%p 0x%08x)\n", info, where);
2340
2341     if(where >= info->num_items)
2342         return FALSE;
2343
2344     if(where < info->num_items - 1)
2345     {
2346         memmove((char*)info->mem + where * info->block_size,
2347                 (char*)info->mem + (where + 1) * info->block_size,
2348                 (info->num_items - where - 1) * info->block_size);
2349     }
2350     memset((char*)info->mem + (info->num_items - 1) * info->block_size,
2351            0, info->block_size);
2352     info->num_items--;
2353     return TRUE;
2354 }
2355
2356 /*************************************************************************
2357  *      @       [SHLWAPI.219]
2358  *
2359  * Call IUnknown_QueryInterface() on a table of objects.
2360  *
2361  * RETURNS
2362  *  Success: S_OK.
2363  *  Failure: E_POINTER or E_NOINTERFACE.
2364  */
2365 HRESULT WINAPI QISearch(
2366         void *base,         /* [in]   Table of interfaces */
2367         const QITAB *table, /* [in]   Array of REFIIDs and indexes into the table */
2368         REFIID riid,        /* [in]   REFIID to get interface for */
2369         void **ppv)         /* [out]  Destination for interface pointer */
2370 {
2371         HRESULT ret;
2372         IUnknown *a_vtbl;
2373         const QITAB *xmove;
2374
2375         TRACE("(%p %p %s %p)\n", base, table, debugstr_guid(riid), ppv);
2376         if (ppv) {
2377             xmove = table;
2378             while (xmove->piid) {
2379                 TRACE("trying (offset %d) %s\n", xmove->dwOffset, debugstr_guid(xmove->piid));
2380                 if (IsEqualIID(riid, xmove->piid)) {
2381                     a_vtbl = (IUnknown*)(xmove->dwOffset + (LPBYTE)base);
2382                     TRACE("matched, returning (%p)\n", a_vtbl);
2383                     *ppv = a_vtbl;
2384                     IUnknown_AddRef(a_vtbl);
2385                     return S_OK;
2386                 }
2387                 xmove++;
2388             }
2389
2390             if (IsEqualIID(riid, &IID_IUnknown)) {
2391                 a_vtbl = (IUnknown*)(table->dwOffset + (LPBYTE)base);
2392                 TRACE("returning first for IUnknown (%p)\n", a_vtbl);
2393                 *ppv = a_vtbl;
2394                 IUnknown_AddRef(a_vtbl);
2395                 return S_OK;
2396             }
2397             *ppv = 0;
2398             ret = E_NOINTERFACE;
2399         } else
2400             ret = E_POINTER;
2401
2402         TRACE("-- 0x%08x\n", ret);
2403         return ret;
2404 }
2405
2406 /*************************************************************************
2407  * @ [SHLWAPI.220]
2408  *
2409  * Set the Font for a window and the "PropDlgFont" property of the parent window.
2410  *
2411  * PARAMS
2412  *  hWnd [I] Parent Window to set the property
2413  *  id   [I] Index of child Window to set the Font
2414  *
2415  * RETURNS
2416  *  Success: S_OK
2417  *
2418  */
2419 HRESULT WINAPI SHSetDefaultDialogFont(HWND hWnd, INT id)
2420 {
2421     FIXME("(%p, %d) stub\n", hWnd, id);
2422     return S_OK;
2423 }
2424
2425 /*************************************************************************
2426  *      @       [SHLWAPI.221]
2427  *
2428  * Remove the "PropDlgFont" property from a window.
2429  *
2430  * PARAMS
2431  *  hWnd [I] Window to remove the property from
2432  *
2433  * RETURNS
2434  *  A handle to the removed property, or NULL if it did not exist.
2435  */
2436 HANDLE WINAPI SHRemoveDefaultDialogFont(HWND hWnd)
2437 {
2438   HANDLE hProp;
2439
2440   TRACE("(%p)\n", hWnd);
2441
2442   hProp = GetPropA(hWnd, "PropDlgFont");
2443
2444   if(hProp)
2445   {
2446     DeleteObject(hProp);
2447     hProp = RemovePropA(hWnd, "PropDlgFont");
2448   }
2449   return hProp;
2450 }
2451
2452 /*************************************************************************
2453  *      @       [SHLWAPI.236]
2454  *
2455  * Load the in-process server of a given GUID.
2456  *
2457  * PARAMS
2458  *  refiid [I] GUID of the server to load.
2459  *
2460  * RETURNS
2461  *  Success: A handle to the loaded server dll.
2462  *  Failure: A NULL handle.
2463  */
2464 HMODULE WINAPI SHPinDllOfCLSID(REFIID refiid)
2465 {
2466     HKEY newkey;
2467     DWORD type, count;
2468     CHAR value[MAX_PATH], string[MAX_PATH];
2469
2470     strcpy(string, "CLSID\\");
2471     SHStringFromGUIDA(refiid, string + 6, sizeof(string)/sizeof(char) - 6);
2472     strcat(string, "\\InProcServer32");
2473
2474     count = MAX_PATH;
2475     RegOpenKeyExA(HKEY_CLASSES_ROOT, string, 0, 1, &newkey);
2476     RegQueryValueExA(newkey, 0, 0, &type, (PBYTE)value, &count);
2477     RegCloseKey(newkey);
2478     return LoadLibraryExA(value, 0, 0);
2479 }
2480
2481 /*************************************************************************
2482  *      @       [SHLWAPI.237]
2483  *
2484  * Unicode version of SHLWAPI_183.
2485  */
2486 DWORD WINAPI SHRegisterClassW(WNDCLASSW * lpWndClass)
2487 {
2488         WNDCLASSW WndClass;
2489
2490         TRACE("(%p %s)\n",lpWndClass->hInstance, debugstr_w(lpWndClass->lpszClassName));
2491
2492         if (GetClassInfoW(lpWndClass->hInstance, lpWndClass->lpszClassName, &WndClass))
2493                 return TRUE;
2494         return RegisterClassW(lpWndClass);
2495 }
2496
2497 /*************************************************************************
2498  *      @       [SHLWAPI.238]
2499  *
2500  * Unregister a list of classes.
2501  *
2502  * PARAMS
2503  *  hInst      [I] Application instance that registered the classes
2504  *  lppClasses [I] List of class names
2505  *  iCount     [I] Number of names in lppClasses
2506  *
2507  * RETURNS
2508  *  Nothing.
2509  */
2510 void WINAPI SHUnregisterClassesA(HINSTANCE hInst, LPCSTR *lppClasses, INT iCount)
2511 {
2512   WNDCLASSA WndClass;
2513
2514   TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2515
2516   while (iCount > 0)
2517   {
2518     if (GetClassInfoA(hInst, *lppClasses, &WndClass))
2519       UnregisterClassA(*lppClasses, hInst);
2520     lppClasses++;
2521     iCount--;
2522   }
2523 }
2524
2525 /*************************************************************************
2526  *      @       [SHLWAPI.239]
2527  *
2528  * Unicode version of SHUnregisterClassesA.
2529  */
2530 void WINAPI SHUnregisterClassesW(HINSTANCE hInst, LPCWSTR *lppClasses, INT iCount)
2531 {
2532   WNDCLASSW WndClass;
2533
2534   TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2535
2536   while (iCount > 0)
2537   {
2538     if (GetClassInfoW(hInst, *lppClasses, &WndClass))
2539       UnregisterClassW(*lppClasses, hInst);
2540     lppClasses++;
2541     iCount--;
2542   }
2543 }
2544
2545 /*************************************************************************
2546  *      @       [SHLWAPI.240]
2547  *
2548  * Call The correct (Ascii/Unicode) default window procedure for a window.
2549  *
2550  * PARAMS
2551  *  hWnd     [I] Window to call the default procedure for
2552  *  uMessage [I] Message ID
2553  *  wParam   [I] WPARAM of message
2554  *  lParam   [I] LPARAM of message
2555  *
2556  * RETURNS
2557  *  The result of calling DefWindowProcA() or DefWindowProcW().
2558  */
2559 LRESULT CALLBACK SHDefWindowProc(HWND hWnd, UINT uMessage, WPARAM wParam, LPARAM lParam)
2560 {
2561         if (IsWindowUnicode(hWnd))
2562                 return DefWindowProcW(hWnd, uMessage, wParam, lParam);
2563         return DefWindowProcA(hWnd, uMessage, wParam, lParam);
2564 }
2565
2566 /*************************************************************************
2567  *      @       [SHLWAPI.256]
2568  */
2569 HRESULT WINAPI IUnknown_GetSite(LPUNKNOWN lpUnknown, REFIID iid, PVOID *lppSite)
2570 {
2571   HRESULT hRet = E_INVALIDARG;
2572   LPOBJECTWITHSITE lpSite = NULL;
2573
2574   TRACE("(%p,%s,%p)\n", lpUnknown, debugstr_guid(iid), lppSite);
2575
2576   if (lpUnknown && iid && lppSite)
2577   {
2578     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IObjectWithSite,
2579                                    (void**)&lpSite);
2580     if (SUCCEEDED(hRet) && lpSite)
2581     {
2582       hRet = IObjectWithSite_GetSite(lpSite, iid, lppSite);
2583       IObjectWithSite_Release(lpSite);
2584     }
2585   }
2586   return hRet;
2587 }
2588
2589 /*************************************************************************
2590  *      @       [SHLWAPI.257]
2591  *
2592  * Create a worker window using CreateWindowExA().
2593  *
2594  * PARAMS
2595  *  wndProc    [I] Window procedure
2596  *  hWndParent [I] Parent window
2597  *  dwExStyle  [I] Extra style flags
2598  *  dwStyle    [I] Style flags
2599  *  hMenu      [I] Window menu
2600  *  wnd_extra  [I] Window extra bytes value
2601  *
2602  * RETURNS
2603  *  Success: The window handle of the newly created window.
2604  *  Failure: 0.
2605  */
2606 HWND WINAPI SHCreateWorkerWindowA(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2607                                   DWORD dwStyle, HMENU hMenu, LONG_PTR wnd_extra)
2608 {
2609   static const char szClass[] = "WorkerA";
2610   WNDCLASSA wc;
2611   HWND hWnd;
2612
2613   TRACE("(0x%08x, %p, 0x%08x, 0x%08x, %p, 0x%08lx)\n",
2614          wndProc, hWndParent, dwExStyle, dwStyle, hMenu, wnd_extra);
2615
2616   /* Create Window class */
2617   wc.style         = 0;
2618   wc.lpfnWndProc   = DefWindowProcA;
2619   wc.cbClsExtra    = 0;
2620   wc.cbWndExtra    = sizeof(LONG_PTR);
2621   wc.hInstance     = shlwapi_hInstance;
2622   wc.hIcon         = NULL;
2623   wc.hCursor       = LoadCursorA(NULL, (LPSTR)IDC_ARROW);
2624   wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2625   wc.lpszMenuName  = NULL;
2626   wc.lpszClassName = szClass;
2627
2628   SHRegisterClassA(&wc);
2629
2630   hWnd = CreateWindowExA(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2631                          hWndParent, hMenu, shlwapi_hInstance, 0);
2632   if (hWnd)
2633   {
2634     SetWindowLongPtrW(hWnd, 0, wnd_extra);
2635
2636     if (wndProc) SetWindowLongPtrA(hWnd, GWLP_WNDPROC, wndProc);
2637   }
2638
2639   return hWnd;
2640 }
2641
2642 typedef struct tagPOLICYDATA
2643 {
2644   DWORD policy;        /* flags value passed to SHRestricted */
2645   LPCWSTR appstr;      /* application str such as "Explorer" */
2646   LPCWSTR keystr;      /* name of the actual registry key / policy */
2647 } POLICYDATA, *LPPOLICYDATA;
2648
2649 #define SHELL_NO_POLICY 0xffffffff
2650
2651 /* default shell policy registry key */
2652 static const WCHAR strRegistryPolicyW[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o',
2653                                       's','o','f','t','\\','W','i','n','d','o','w','s','\\',
2654                                       'C','u','r','r','e','n','t','V','e','r','s','i','o','n',
2655                                       '\\','P','o','l','i','c','i','e','s',0};
2656
2657 /*************************************************************************
2658  * @                          [SHLWAPI.271]
2659  *
2660  * Retrieve a policy value from the registry.
2661  *
2662  * PARAMS
2663  *  lpSubKey   [I]   registry key name
2664  *  lpSubName  [I]   subname of registry key
2665  *  lpValue    [I]   value name of registry value
2666  *
2667  * RETURNS
2668  *  the value associated with the registry key or 0 if not found
2669  */
2670 DWORD WINAPI SHGetRestriction(LPCWSTR lpSubKey, LPCWSTR lpSubName, LPCWSTR lpValue)
2671 {
2672         DWORD retval, datsize = sizeof(retval);
2673         HKEY hKey;
2674
2675         if (!lpSubKey)
2676           lpSubKey = strRegistryPolicyW;
2677
2678         retval = RegOpenKeyW(HKEY_LOCAL_MACHINE, lpSubKey, &hKey);
2679     if (retval != ERROR_SUCCESS)
2680           retval = RegOpenKeyW(HKEY_CURRENT_USER, lpSubKey, &hKey);
2681         if (retval != ERROR_SUCCESS)
2682           return 0;
2683
2684         SHGetValueW(hKey, lpSubName, lpValue, NULL, &retval, &datsize);
2685         RegCloseKey(hKey);
2686         return retval;
2687 }
2688
2689 /*************************************************************************
2690  * @                         [SHLWAPI.266]
2691  *
2692  * Helper function to retrieve the possibly cached value for a specific policy
2693  *
2694  * PARAMS
2695  *  policy     [I]   The policy to look for
2696  *  initial    [I]   Main registry key to open, if NULL use default
2697  *  polTable   [I]   Table of known policies, 0 terminated
2698  *  polArr     [I]   Cache array of policy values
2699  *
2700  * RETURNS
2701  *  The retrieved policy value or 0 if not successful
2702  *
2703  * NOTES
2704  *  This function is used by the native SHRestricted function to search for the
2705  *  policy and cache it once retrieved. The current Wine implementation uses a
2706  *  different POLICYDATA structure and implements a similar algorithm adapted to
2707  *  that structure.
2708  */
2709 DWORD WINAPI SHRestrictionLookup(
2710         DWORD policy,
2711         LPCWSTR initial,
2712         LPPOLICYDATA polTable,
2713         LPDWORD polArr)
2714 {
2715         TRACE("(0x%08x %s %p %p)\n", policy, debugstr_w(initial), polTable, polArr);
2716
2717         if (!polTable || !polArr)
2718           return 0;
2719
2720         for (;polTable->policy; polTable++, polArr++)
2721         {
2722           if (policy == polTable->policy)
2723           {
2724             /* we have a known policy */
2725
2726             /* check if this policy has been cached */
2727                 if (*polArr == SHELL_NO_POLICY)
2728               *polArr = SHGetRestriction(initial, polTable->appstr, polTable->keystr);
2729             return *polArr;
2730           }
2731         }
2732         /* we don't know this policy, return 0 */
2733         TRACE("unknown policy: (%08x)\n", policy);
2734         return 0;
2735 }
2736
2737 /*************************************************************************
2738  *      @       [SHLWAPI.267]
2739  *
2740  * Get an interface from an object.
2741  *
2742  * RETURNS
2743  *  Success: S_OK. ppv contains the requested interface.
2744  *  Failure: An HRESULT error code.
2745  *
2746  * NOTES
2747  *   This QueryInterface asks the inner object for an interface. In case
2748  *   of aggregation this request would be forwarded by the inner to the
2749  *   outer object. This function asks the inner object directly for the
2750  *   interface circumventing the forwarding to the outer object.
2751  */
2752 HRESULT WINAPI SHWeakQueryInterface(
2753         IUnknown * pUnk,   /* [in] Outer object */
2754         IUnknown * pInner, /* [in] Inner object */
2755         IID * riid, /* [in] Interface GUID to query for */
2756         LPVOID* ppv) /* [out] Destination for queried interface */
2757 {
2758         HRESULT hret = E_NOINTERFACE;
2759         TRACE("(pUnk=%p pInner=%p\n\tIID:  %s %p)\n",pUnk,pInner,debugstr_guid(riid), ppv);
2760
2761         *ppv = NULL;
2762         if(pUnk && pInner) {
2763             hret = IUnknown_QueryInterface(pInner, riid, ppv);
2764             if (SUCCEEDED(hret)) IUnknown_Release(pUnk);
2765         }
2766         TRACE("-- 0x%08x\n", hret);
2767         return hret;
2768 }
2769
2770 /*************************************************************************
2771  *      @       [SHLWAPI.268]
2772  *
2773  * Move a reference from one interface to another.
2774  *
2775  * PARAMS
2776  *   lpDest     [O] Destination to receive the reference
2777  *   lppUnknown [O] Source to give up the reference to lpDest
2778  *
2779  * RETURNS
2780  *  Nothing.
2781  */
2782 VOID WINAPI SHWeakReleaseInterface(IUnknown *lpDest, IUnknown **lppUnknown)
2783 {
2784   TRACE("(%p,%p)\n", lpDest, lppUnknown);
2785
2786   if (*lppUnknown)
2787   {
2788     /* Copy Reference*/
2789     IUnknown_AddRef(lpDest);
2790     IUnknown_AtomicRelease(lppUnknown); /* Release existing interface */
2791   }
2792 }
2793
2794 /*************************************************************************
2795  *      @       [SHLWAPI.269]
2796  *
2797  * Convert an ASCII string of a CLSID into a CLSID.
2798  *
2799  * PARAMS
2800  *  idstr [I] String representing a CLSID in registry format
2801  *  id    [O] Destination for the converted CLSID
2802  *
2803  * RETURNS
2804  *  Success: TRUE. id contains the converted CLSID.
2805  *  Failure: FALSE.
2806  */
2807 BOOL WINAPI GUIDFromStringA(LPCSTR idstr, CLSID *id)
2808 {
2809   WCHAR wClsid[40];
2810   MultiByteToWideChar(CP_ACP, 0, idstr, -1, wClsid, sizeof(wClsid)/sizeof(WCHAR));
2811   return SUCCEEDED(CLSIDFromString(wClsid, id));
2812 }
2813
2814 /*************************************************************************
2815  *      @       [SHLWAPI.270]
2816  *
2817  * Unicode version of GUIDFromStringA.
2818  */
2819 BOOL WINAPI GUIDFromStringW(LPCWSTR idstr, CLSID *id)
2820 {
2821     return SUCCEEDED(CLSIDFromString((LPCOLESTR)idstr, id));
2822 }
2823
2824 /*************************************************************************
2825  *      @       [SHLWAPI.276]
2826  *
2827  * Determine if the browser is integrated into the shell, and set a registry
2828  * key accordingly.
2829  *
2830  * PARAMS
2831  *  None.
2832  *
2833  * RETURNS
2834  *  1, If the browser is not integrated.
2835  *  2, If the browser is integrated.
2836  *
2837  * NOTES
2838  *  The key "HKLM\Software\Microsoft\Internet Explorer\IntegratedBrowser" is
2839  *  either set to TRUE, or removed depending on whether the browser is deemed
2840  *  to be integrated.
2841  */
2842 DWORD WINAPI WhichPlatform(void)
2843 {
2844   static const char szIntegratedBrowser[] = "IntegratedBrowser";
2845   static DWORD dwState = 0;
2846   HKEY hKey;
2847   DWORD dwRet, dwData, dwSize;
2848   HMODULE hshell32;
2849
2850   if (dwState)
2851     return dwState;
2852
2853   /* If shell32 exports DllGetVersion(), the browser is integrated */
2854   dwState = 1;
2855   hshell32 = LoadLibraryA("shell32.dll");
2856   if (hshell32)
2857   {
2858     FARPROC pDllGetVersion;
2859     pDllGetVersion = GetProcAddress(hshell32, "DllGetVersion");
2860     dwState = pDllGetVersion ? 2 : 1;
2861     FreeLibrary(hshell32);
2862   }
2863
2864   /* Set or delete the key accordingly */
2865   dwRet = RegOpenKeyExA(HKEY_LOCAL_MACHINE,
2866                         "Software\\Microsoft\\Internet Explorer", 0,
2867                          KEY_ALL_ACCESS, &hKey);
2868   if (!dwRet)
2869   {
2870     dwRet = RegQueryValueExA(hKey, szIntegratedBrowser, 0, 0,
2871                              (LPBYTE)&dwData, &dwSize);
2872
2873     if (!dwRet && dwState == 1)
2874     {
2875       /* Value exists but browser is not integrated */
2876       RegDeleteValueA(hKey, szIntegratedBrowser);
2877     }
2878     else if (dwRet && dwState == 2)
2879     {
2880       /* Browser is integrated but value does not exist */
2881       dwData = TRUE;
2882       RegSetValueExA(hKey, szIntegratedBrowser, 0, REG_DWORD,
2883                      (LPBYTE)&dwData, sizeof(dwData));
2884     }
2885     RegCloseKey(hKey);
2886   }
2887   return dwState;
2888 }
2889
2890 /*************************************************************************
2891  *      @       [SHLWAPI.278]
2892  *
2893  * Unicode version of SHCreateWorkerWindowA.
2894  */
2895 HWND WINAPI SHCreateWorkerWindowW(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2896                         DWORD dwStyle, HMENU hMenu, LONG msg_result)
2897 {
2898   static const WCHAR szClass[] = { 'W', 'o', 'r', 'k', 'e', 'r', 'W', 0 };
2899   WNDCLASSW wc;
2900   HWND hWnd;
2901
2902   TRACE("(0x%08x, %p, 0x%08x, 0x%08x, %p, 0x%08x)\n",
2903          wndProc, hWndParent, dwExStyle, dwStyle, hMenu, msg_result);
2904
2905   /* If our OS is natively ANSI, use the ANSI version */
2906   if (GetVersion() & 0x80000000)  /* not NT */
2907   {
2908     TRACE("fallback to ANSI, ver 0x%08x\n", GetVersion());
2909     return SHCreateWorkerWindowA(wndProc, hWndParent, dwExStyle, dwStyle, hMenu, msg_result);
2910   }
2911
2912   /* Create Window class */
2913   wc.style         = 0;
2914   wc.lpfnWndProc   = DefWindowProcW;
2915   wc.cbClsExtra    = 0;
2916   wc.cbWndExtra    = 4;
2917   wc.hInstance     = shlwapi_hInstance;
2918   wc.hIcon         = NULL;
2919   wc.hCursor       = LoadCursorW(NULL, (LPWSTR)IDC_ARROW);
2920   wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2921   wc.lpszMenuName  = NULL;
2922   wc.lpszClassName = szClass;
2923
2924   SHRegisterClassW(&wc);
2925
2926   hWnd = CreateWindowExW(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2927                          hWndParent, hMenu, shlwapi_hInstance, 0);
2928   if (hWnd)
2929   {
2930     SetWindowLongPtrW(hWnd, DWLP_MSGRESULT, msg_result);
2931
2932     if (wndProc) SetWindowLongPtrW(hWnd, GWLP_WNDPROC, wndProc);
2933   }
2934
2935   return hWnd;
2936 }
2937
2938 /*************************************************************************
2939  *      @       [SHLWAPI.279]
2940  *
2941  * Get and show a context menu from a shell folder.
2942  *
2943  * PARAMS
2944  *  hWnd           [I] Window displaying the shell folder
2945  *  lpFolder       [I] IShellFolder interface
2946  *  lpApidl        [I] Id for the particular folder desired
2947  *
2948  * RETURNS
2949  *  Success: S_OK.
2950  *  Failure: An HRESULT error code indicating the error.
2951  */
2952 HRESULT WINAPI SHInvokeDefaultCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl)
2953 {
2954     TRACE("%p %p %p\n", hWnd, lpFolder, lpApidl);
2955     return SHInvokeCommand(hWnd, lpFolder, lpApidl, FALSE);
2956 }
2957
2958 /*************************************************************************
2959  *      @       [SHLWAPI.281]
2960  *
2961  * _SHPackDispParamsV
2962  */
2963 HRESULT WINAPI SHPackDispParamsV(DISPPARAMS *params, VARIANTARG *args, UINT cnt, __ms_va_list valist)
2964 {
2965   VARIANTARG *iter;
2966
2967   TRACE("(%p %p %u ...)\n", params, args, cnt);
2968
2969   params->rgvarg = args;
2970   params->rgdispidNamedArgs = NULL;
2971   params->cArgs = cnt;
2972   params->cNamedArgs = 0;
2973
2974   iter = args+cnt;
2975
2976   while(iter-- > args) {
2977     V_VT(iter) = va_arg(valist, enum VARENUM);
2978
2979     TRACE("vt=%d\n", V_VT(iter));
2980
2981     if(V_VT(iter) & VT_BYREF) {
2982       V_BYREF(iter) = va_arg(valist, LPVOID);
2983     } else {
2984       switch(V_VT(iter)) {
2985       case VT_I4:
2986         V_I4(iter) = va_arg(valist, LONG);
2987         break;
2988       case VT_BSTR:
2989         V_BSTR(iter) = va_arg(valist, BSTR);
2990         break;
2991       case VT_DISPATCH:
2992         V_DISPATCH(iter) = va_arg(valist, IDispatch*);
2993         break;
2994       case VT_BOOL:
2995         V_BOOL(iter) = va_arg(valist, int);
2996         break;
2997       case VT_UNKNOWN:
2998         V_UNKNOWN(iter) = va_arg(valist, IUnknown*);
2999         break;
3000       default:
3001         V_VT(iter) = VT_I4;
3002         V_I4(iter) = va_arg(valist, LONG);
3003       }
3004     }
3005   }
3006
3007   return S_OK;
3008 }
3009
3010 /*************************************************************************
3011  *      @       [SHLWAPI.282]
3012  *
3013  * SHPackDispParams
3014  */
3015 HRESULT WINAPIV SHPackDispParams(DISPPARAMS *params, VARIANTARG *args, UINT cnt, ...)
3016 {
3017   __ms_va_list valist;
3018   HRESULT hres;
3019
3020   __ms_va_start(valist, cnt);
3021   hres = SHPackDispParamsV(params, args, cnt, valist);
3022   __ms_va_end(valist);
3023   return hres;
3024 }
3025
3026 /*************************************************************************
3027  *      SHLWAPI_InvokeByIID
3028  *
3029  *   This helper function calls IDispatch::Invoke for each sink
3030  * which implements given iid or IDispatch.
3031  *
3032  */
3033 static HRESULT SHLWAPI_InvokeByIID(
3034         IConnectionPoint* iCP,
3035         REFIID iid,
3036         DISPID dispId,
3037         DISPPARAMS* dispParams)
3038 {
3039   IEnumConnections *enumerator;
3040   CONNECTDATA rgcd;
3041   static DISPPARAMS empty = {NULL, NULL, 0, 0};
3042   DISPPARAMS* params = dispParams;
3043
3044   HRESULT result = IConnectionPoint_EnumConnections(iCP, &enumerator);
3045   if (FAILED(result))
3046     return result;
3047
3048   /* Invoke is never happening with an NULL dispParams */
3049   if (!params)
3050     params = &empty;
3051
3052   while(IEnumConnections_Next(enumerator, 1, &rgcd, NULL)==S_OK)
3053   {
3054     IDispatch *dispIface;
3055     if ((iid && SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, iid, (LPVOID*)&dispIface))) ||
3056         SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, &IID_IDispatch, (LPVOID*)&dispIface)))
3057     {
3058       IDispatch_Invoke(dispIface, dispId, &IID_NULL, 0, DISPATCH_METHOD, params, NULL, NULL, NULL);
3059       IDispatch_Release(dispIface);
3060     }
3061     IUnknown_Release(rgcd.pUnk);
3062   }
3063
3064   IEnumConnections_Release(enumerator);
3065
3066   return S_OK;
3067 }
3068
3069 /*************************************************************************
3070  *  IConnectionPoint_InvokeWithCancel   [SHLWAPI.283]
3071  */
3072 HRESULT WINAPI IConnectionPoint_InvokeWithCancel( IConnectionPoint* iCP,
3073                                                   DISPID dispId, DISPPARAMS* dispParams,
3074                                                   DWORD unknown1, DWORD unknown2 )
3075 {
3076     IID iid;
3077     HRESULT result;
3078
3079     FIXME("(%p)->(0x%x %p %x %x) partial stub\n", iCP, dispId, dispParams, unknown1, unknown2);
3080
3081     result = IConnectionPoint_GetConnectionInterface(iCP, &iid);
3082     if (SUCCEEDED(result))
3083         result = SHLWAPI_InvokeByIID(iCP, &iid, dispId, dispParams);
3084     else
3085         result = SHLWAPI_InvokeByIID(iCP, NULL, dispId, dispParams);
3086
3087     return result;
3088 }
3089
3090
3091 /*************************************************************************
3092  *      @       [SHLWAPI.284]
3093  *
3094  *  IConnectionPoint_SimpleInvoke
3095  */
3096 HRESULT WINAPI IConnectionPoint_SimpleInvoke(
3097         IConnectionPoint* iCP,
3098         DISPID dispId,
3099         DISPPARAMS* dispParams)
3100 {
3101   IID iid;
3102   HRESULT result;
3103
3104   TRACE("(%p)->(0x%x %p)\n",iCP,dispId,dispParams);
3105
3106   result = IConnectionPoint_GetConnectionInterface(iCP, &iid);
3107   if (SUCCEEDED(result))
3108     result = SHLWAPI_InvokeByIID(iCP, &iid, dispId, dispParams);
3109   else
3110     result = SHLWAPI_InvokeByIID(iCP, NULL, dispId, dispParams);
3111
3112   return result;
3113 }
3114
3115 /*************************************************************************
3116  *      @       [SHLWAPI.285]
3117  *
3118  * Notify an IConnectionPoint object of changes.
3119  *
3120  * PARAMS
3121  *  lpCP   [I] Object to notify
3122  *  dispID [I]
3123  *
3124  * RETURNS
3125  *  Success: S_OK.
3126  *  Failure: E_NOINTERFACE, if lpCP is NULL or does not support the
3127  *           IConnectionPoint interface.
3128  */
3129 HRESULT WINAPI IConnectionPoint_OnChanged(IConnectionPoint* lpCP, DISPID dispID)
3130 {
3131   IEnumConnections *lpEnum;
3132   HRESULT hRet = E_NOINTERFACE;
3133
3134   TRACE("(%p,0x%8X)\n", lpCP, dispID);
3135
3136   /* Get an enumerator for the connections */
3137   if (lpCP)
3138     hRet = IConnectionPoint_EnumConnections(lpCP, &lpEnum);
3139
3140   if (SUCCEEDED(hRet))
3141   {
3142     IPropertyNotifySink *lpSink;
3143     CONNECTDATA connData;
3144     ULONG ulFetched;
3145
3146     /* Call OnChanged() for every notify sink in the connection point */
3147     while (IEnumConnections_Next(lpEnum, 1, &connData, &ulFetched) == S_OK)
3148     {
3149       if (SUCCEEDED(IUnknown_QueryInterface(connData.pUnk, &IID_IPropertyNotifySink, (void**)&lpSink)) &&
3150           lpSink)
3151       {
3152         IPropertyNotifySink_OnChanged(lpSink, dispID);
3153         IPropertyNotifySink_Release(lpSink);
3154       }
3155       IUnknown_Release(connData.pUnk);
3156     }
3157
3158     IEnumConnections_Release(lpEnum);
3159   }
3160   return hRet;
3161 }
3162
3163 /*************************************************************************
3164  *      @       [SHLWAPI.286]
3165  *
3166  *  IUnknown_CPContainerInvokeParam
3167  */
3168 HRESULT WINAPIV IUnknown_CPContainerInvokeParam(
3169         IUnknown *container,
3170         REFIID riid,
3171         DISPID dispId,
3172         VARIANTARG* buffer,
3173         DWORD cParams, ...)
3174 {
3175   HRESULT result;
3176   IConnectionPoint *iCP;
3177   IConnectionPointContainer *iCPC;
3178   DISPPARAMS dispParams = {buffer, NULL, cParams, 0};
3179   __ms_va_list valist;
3180
3181   if (!container)
3182     return E_NOINTERFACE;
3183
3184   result = IUnknown_QueryInterface(container, &IID_IConnectionPointContainer,(LPVOID*) &iCPC);
3185   if (FAILED(result))
3186       return result;
3187
3188   result = IConnectionPointContainer_FindConnectionPoint(iCPC, riid, &iCP);
3189   IConnectionPointContainer_Release(iCPC);
3190   if(FAILED(result))
3191       return result;
3192
3193   __ms_va_start(valist, cParams);
3194   SHPackDispParamsV(&dispParams, buffer, cParams, valist);
3195   __ms_va_end(valist);
3196
3197   result = SHLWAPI_InvokeByIID(iCP, riid, dispId, &dispParams);
3198   IConnectionPoint_Release(iCP);
3199
3200   return result;
3201 }
3202
3203 /*************************************************************************
3204  *      @       [SHLWAPI.287]
3205  *
3206  * Notify an IConnectionPointContainer object of changes.
3207  *
3208  * PARAMS
3209  *  lpUnknown [I] Object to notify
3210  *  dispID    [I]
3211  *
3212  * RETURNS
3213  *  Success: S_OK.
3214  *  Failure: E_NOINTERFACE, if lpUnknown is NULL or does not support the
3215  *           IConnectionPointContainer interface.
3216  */
3217 HRESULT WINAPI IUnknown_CPContainerOnChanged(IUnknown *lpUnknown, DISPID dispID)
3218 {
3219   IConnectionPointContainer* lpCPC = NULL;
3220   HRESULT hRet = E_NOINTERFACE;
3221
3222   TRACE("(%p,0x%8X)\n", lpUnknown, dispID);
3223
3224   if (lpUnknown)
3225     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer, (void**)&lpCPC);
3226
3227   if (SUCCEEDED(hRet))
3228   {
3229     IConnectionPoint* lpCP;
3230
3231     hRet = IConnectionPointContainer_FindConnectionPoint(lpCPC, &IID_IPropertyNotifySink, &lpCP);
3232     IConnectionPointContainer_Release(lpCPC);
3233
3234     hRet = IConnectionPoint_OnChanged(lpCP, dispID);
3235     IConnectionPoint_Release(lpCP);
3236   }
3237   return hRet;
3238 }
3239
3240 /*************************************************************************
3241  *      @       [SHLWAPI.289]
3242  *
3243  * See PlaySoundW.
3244  */
3245 BOOL WINAPI PlaySoundWrapW(LPCWSTR pszSound, HMODULE hmod, DWORD fdwSound)
3246 {
3247     return PlaySoundW(pszSound, hmod, fdwSound);
3248 }
3249
3250 /*************************************************************************
3251  *      @       [SHLWAPI.294]
3252  *
3253  * Retrieve a key value from an INI file.  See GetPrivateProfileString for
3254  * more information.
3255  *
3256  * PARAMS
3257  *  appName   [I] The section in the INI file that contains the key
3258  *  keyName   [I] The key to be retrieved
3259  *  out       [O] The buffer into which the key's value will be copied
3260  *  outLen    [I] The length of the `out' buffer
3261  *  filename  [I] The location of the INI file
3262  *
3263  * RETURNS
3264  *  Length of string copied into `out'.
3265  */
3266 DWORD WINAPI SHGetIniStringW(LPCWSTR appName, LPCWSTR keyName, LPWSTR out,
3267         DWORD outLen, LPCWSTR filename)
3268 {
3269     INT ret;
3270     WCHAR *buf;
3271
3272     TRACE("(%s,%s,%p,%08x,%s)\n", debugstr_w(appName), debugstr_w(keyName),
3273         out, outLen, debugstr_w(filename));
3274
3275     if(outLen == 0)
3276         return 0;
3277
3278     buf = HeapAlloc(GetProcessHeap(), 0, outLen * sizeof(WCHAR));
3279     if(!buf){
3280         *out = 0;
3281         return 0;
3282     }
3283
3284     ret = GetPrivateProfileStringW(appName, keyName, NULL, buf, outLen, filename);
3285     if(ret)
3286         strcpyW(out, buf);
3287     else
3288         *out = 0;
3289
3290     HeapFree(GetProcessHeap(), 0, buf);
3291
3292     return strlenW(out);
3293 }
3294
3295 /*************************************************************************
3296  *      @       [SHLWAPI.295]
3297  *
3298  * Set a key value in an INI file.  See WritePrivateProfileString for
3299  * more information.
3300  *
3301  * PARAMS
3302  *  appName   [I] The section in the INI file that contains the key
3303  *  keyName   [I] The key to be set
3304  *  str       [O] The value of the key
3305  *  filename  [I] The location of the INI file
3306  *
3307  * RETURNS
3308  *   Success: TRUE
3309  *   Failure: FALSE
3310  */
3311 BOOL WINAPI SHSetIniStringW(LPCWSTR appName, LPCWSTR keyName, LPCWSTR str,
3312         LPCWSTR filename)
3313 {
3314     TRACE("(%s, %p, %s, %s)\n", debugstr_w(appName), keyName, debugstr_w(str),
3315             debugstr_w(filename));
3316
3317     return WritePrivateProfileStringW(appName, keyName, str, filename);
3318 }
3319
3320 /*************************************************************************
3321  *      @       [SHLWAPI.313]
3322  *
3323  * See SHGetFileInfoW.
3324  */
3325 DWORD WINAPI SHGetFileInfoWrapW(LPCWSTR path, DWORD dwFileAttributes,
3326                          SHFILEINFOW *psfi, UINT sizeofpsfi, UINT flags)
3327 {
3328     return SHGetFileInfoW(path, dwFileAttributes, psfi, sizeofpsfi, flags);
3329 }
3330
3331 /*************************************************************************
3332  *      @       [SHLWAPI.318]
3333  *
3334  * See DragQueryFileW.
3335  */
3336 UINT WINAPI DragQueryFileWrapW(HDROP hDrop, UINT lFile, LPWSTR lpszFile, UINT lLength)
3337 {
3338     return DragQueryFileW(hDrop, lFile, lpszFile, lLength);
3339 }
3340
3341 /*************************************************************************
3342  *      @       [SHLWAPI.333]
3343  *
3344  * See SHBrowseForFolderW.
3345  */
3346 LPITEMIDLIST WINAPI SHBrowseForFolderWrapW(LPBROWSEINFOW lpBi)
3347 {
3348     return SHBrowseForFolderW(lpBi);
3349 }
3350
3351 /*************************************************************************
3352  *      @       [SHLWAPI.334]
3353  *
3354  * See SHGetPathFromIDListW.
3355  */
3356 BOOL WINAPI SHGetPathFromIDListWrapW(LPCITEMIDLIST pidl,LPWSTR pszPath)
3357 {
3358     return SHGetPathFromIDListW(pidl, pszPath);
3359 }
3360
3361 /*************************************************************************
3362  *      @       [SHLWAPI.335]
3363  *
3364  * See ShellExecuteExW.
3365  */
3366 BOOL WINAPI ShellExecuteExWrapW(LPSHELLEXECUTEINFOW lpExecInfo)
3367 {
3368     return ShellExecuteExW(lpExecInfo);
3369 }
3370
3371 /*************************************************************************
3372  *      @       [SHLWAPI.336]
3373  *
3374  * See SHFileOperationW.
3375  */
3376 INT WINAPI SHFileOperationWrapW(LPSHFILEOPSTRUCTW lpFileOp)
3377 {
3378     return SHFileOperationW(lpFileOp);
3379 }
3380
3381 /*************************************************************************
3382  *      @       [SHLWAPI.342]
3383  *
3384  */
3385 PVOID WINAPI SHInterlockedCompareExchange( PVOID *dest, PVOID xchg, PVOID compare )
3386 {
3387     return InterlockedCompareExchangePointer( dest, xchg, compare );
3388 }
3389
3390 /*************************************************************************
3391  *      @       [SHLWAPI.350]
3392  *
3393  * See GetFileVersionInfoSizeW.
3394  */
3395 DWORD WINAPI GetFileVersionInfoSizeWrapW( LPCWSTR filename, LPDWORD handle )
3396 {
3397     return GetFileVersionInfoSizeW( filename, handle );
3398 }
3399
3400 /*************************************************************************
3401  *      @       [SHLWAPI.351]
3402  *
3403  * See GetFileVersionInfoW.
3404  */
3405 BOOL  WINAPI GetFileVersionInfoWrapW( LPCWSTR filename, DWORD handle,
3406                                       DWORD datasize, LPVOID data )
3407 {
3408     return GetFileVersionInfoW( filename, handle, datasize, data );
3409 }
3410
3411 /*************************************************************************
3412  *      @       [SHLWAPI.352]
3413  *
3414  * See VerQueryValueW.
3415  */
3416 WORD WINAPI VerQueryValueWrapW( LPVOID pBlock, LPCWSTR lpSubBlock,
3417                                 LPVOID *lplpBuffer, UINT *puLen )
3418 {
3419     return VerQueryValueW( pBlock, lpSubBlock, lplpBuffer, puLen );
3420 }
3421
3422 #define IsIface(type) SUCCEEDED((hRet = IUnknown_QueryInterface(lpUnknown, &IID_##type, (void**)&lpObj)))
3423 #define IShellBrowser_EnableModeless IShellBrowser_EnableModelessSB
3424 #define EnableModeless(type) type##_EnableModeless((type*)lpObj, bModeless)
3425
3426 /*************************************************************************
3427  *      @       [SHLWAPI.355]
3428  *
3429  * Change the modality of a shell object.
3430  *
3431  * PARAMS
3432  *  lpUnknown [I] Object to make modeless
3433  *  bModeless [I] TRUE=Make modeless, FALSE=Make modal
3434  *
3435  * RETURNS
3436  *  Success: S_OK. The modality lpUnknown is changed.
3437  *  Failure: An HRESULT error code indicating the error.
3438  *
3439  * NOTES
3440  *  lpUnknown must support the IOleInPlaceFrame interface, the
3441  *  IInternetSecurityMgrSite interface, the IShellBrowser interface
3442  *  the IDocHostUIHandler interface, or the IOleInPlaceActiveObject interface,
3443  *  or this call will fail.
3444  */
3445 HRESULT WINAPI IUnknown_EnableModeless(IUnknown *lpUnknown, BOOL bModeless)
3446 {
3447   IUnknown *lpObj;
3448   HRESULT hRet;
3449
3450   TRACE("(%p,%d)\n", lpUnknown, bModeless);
3451
3452   if (!lpUnknown)
3453     return E_FAIL;
3454
3455   if (IsIface(IOleInPlaceActiveObject))
3456     EnableModeless(IOleInPlaceActiveObject);
3457   else if (IsIface(IOleInPlaceFrame))
3458     EnableModeless(IOleInPlaceFrame);
3459   else if (IsIface(IShellBrowser))
3460     EnableModeless(IShellBrowser);
3461   else if (IsIface(IInternetSecurityMgrSite))
3462     EnableModeless(IInternetSecurityMgrSite);
3463   else if (IsIface(IDocHostUIHandler))
3464     EnableModeless(IDocHostUIHandler);
3465   else
3466     return hRet;
3467
3468   IUnknown_Release(lpObj);
3469   return S_OK;
3470 }
3471
3472 /*************************************************************************
3473  *      @       [SHLWAPI.357]
3474  *
3475  * See SHGetNewLinkInfoW.
3476  */
3477 BOOL WINAPI SHGetNewLinkInfoWrapW(LPCWSTR pszLinkTo, LPCWSTR pszDir, LPWSTR pszName,
3478                         BOOL *pfMustCopy, UINT uFlags)
3479 {
3480     return SHGetNewLinkInfoW(pszLinkTo, pszDir, pszName, pfMustCopy, uFlags);
3481 }
3482
3483 /*************************************************************************
3484  *      @       [SHLWAPI.358]
3485  *
3486  * See SHDefExtractIconW.
3487  */
3488 UINT WINAPI SHDefExtractIconWrapW(LPCWSTR pszIconFile, int iIndex, UINT uFlags, HICON* phiconLarge,
3489                          HICON* phiconSmall, UINT nIconSize)
3490 {
3491     return SHDefExtractIconW(pszIconFile, iIndex, uFlags, phiconLarge, phiconSmall, nIconSize);
3492 }
3493
3494 /*************************************************************************
3495  *      @       [SHLWAPI.363]
3496  *
3497  * Get and show a context menu from a shell folder.
3498  *
3499  * PARAMS
3500  *  hWnd           [I] Window displaying the shell folder
3501  *  lpFolder       [I] IShellFolder interface
3502  *  lpApidl        [I] Id for the particular folder desired
3503  *  bInvokeDefault [I] Whether to invoke the default menu item
3504  *
3505  * RETURNS
3506  *  Success: S_OK. If bInvokeDefault is TRUE, the default menu action was
3507  *           executed.
3508  *  Failure: An HRESULT error code indicating the error.
3509  */
3510 HRESULT WINAPI SHInvokeCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl, BOOL bInvokeDefault)
3511 {
3512   IContextMenu *iContext;
3513   HRESULT hRet;
3514
3515   TRACE("(%p, %p, %p, %d)\n", hWnd, lpFolder, lpApidl, bInvokeDefault);
3516
3517   if (!lpFolder)
3518     return E_FAIL;
3519
3520   /* Get the context menu from the shell folder */
3521   hRet = IShellFolder_GetUIObjectOf(lpFolder, hWnd, 1, &lpApidl,
3522                                     &IID_IContextMenu, 0, (void**)&iContext);
3523   if (SUCCEEDED(hRet))
3524   {
3525     HMENU hMenu;
3526     if ((hMenu = CreatePopupMenu()))
3527     {
3528       HRESULT hQuery;
3529       DWORD dwDefaultId = 0;
3530
3531       /* Add the context menu entries to the popup */
3532       hQuery = IContextMenu_QueryContextMenu(iContext, hMenu, 0, 1, 0x7FFF,
3533                                              bInvokeDefault ? CMF_NORMAL : CMF_DEFAULTONLY);
3534
3535       if (SUCCEEDED(hQuery))
3536       {
3537         if (bInvokeDefault &&
3538             (dwDefaultId = GetMenuDefaultItem(hMenu, 0, 0)) != (UINT)-1)
3539         {
3540           CMINVOKECOMMANDINFO cmIci;
3541           /* Invoke the default item */
3542           memset(&cmIci,0,sizeof(cmIci));
3543           cmIci.cbSize = sizeof(cmIci);
3544           cmIci.fMask = CMIC_MASK_ASYNCOK;
3545           cmIci.hwnd = hWnd;
3546           cmIci.lpVerb = MAKEINTRESOURCEA(dwDefaultId);
3547           cmIci.nShow = SW_SCROLLCHILDREN;
3548
3549           hRet = IContextMenu_InvokeCommand(iContext, &cmIci);
3550         }
3551       }
3552       DestroyMenu(hMenu);
3553     }
3554     IContextMenu_Release(iContext);
3555   }
3556   return hRet;
3557 }
3558
3559 /*************************************************************************
3560  *      @       [SHLWAPI.370]
3561  *
3562  * See ExtractIconW.
3563  */
3564 HICON WINAPI ExtractIconWrapW(HINSTANCE hInstance, LPCWSTR lpszExeFileName,
3565                          UINT nIconIndex)
3566 {
3567     return ExtractIconW(hInstance, lpszExeFileName, nIconIndex);
3568 }
3569
3570 /*************************************************************************
3571  *      @       [SHLWAPI.377]
3572  *
3573  * Load a library from the directory of a particular process.
3574  *
3575  * PARAMS
3576  *  new_mod        [I] Library name
3577  *  inst_hwnd      [I] Module whose directory is to be used
3578  *  dwCrossCodePage [I] Should be FALSE (currently ignored)
3579  *
3580  * RETURNS
3581  *  Success: A handle to the loaded module
3582  *  Failure: A NULL handle.
3583  */
3584 HMODULE WINAPI MLLoadLibraryA(LPCSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3585 {
3586   /* FIXME: Native appears to do DPA_Create and a DPA_InsertPtr for
3587    *        each call here.
3588    * FIXME: Native shows calls to:
3589    *  SHRegGetUSValue for "Software\Microsoft\Internet Explorer\International"
3590    *                      CheckVersion
3591    *  RegOpenKeyExA for "HKLM\Software\Microsoft\Internet Explorer"
3592    *  RegQueryValueExA for "LPKInstalled"
3593    *  RegCloseKey
3594    *  RegOpenKeyExA for "HKCU\Software\Microsoft\Internet Explorer\International"
3595    *  RegQueryValueExA for "ResourceLocale"
3596    *  RegCloseKey
3597    *  RegOpenKeyExA for "HKLM\Software\Microsoft\Active Setup\Installed Components\{guid}"
3598    *  RegQueryValueExA for "Locale"
3599    *  RegCloseKey
3600    *  and then tests the Locale ("en" for me).
3601    *     code below
3602    *  after the code then a DPA_Create (first time) and DPA_InsertPtr are done.
3603    */
3604     CHAR mod_path[2*MAX_PATH];
3605     LPSTR ptr;
3606     DWORD len;
3607
3608     FIXME("(%s,%p,%d) semi-stub!\n", debugstr_a(new_mod), inst_hwnd, dwCrossCodePage);
3609     len = GetModuleFileNameA(inst_hwnd, mod_path, sizeof(mod_path));
3610     if (!len || len >= sizeof(mod_path)) return NULL;
3611
3612     ptr = strrchr(mod_path, '\\');
3613     if (ptr) {
3614         strcpy(ptr+1, new_mod);
3615         TRACE("loading %s\n", debugstr_a(mod_path));
3616         return LoadLibraryA(mod_path);
3617     }
3618     return NULL;
3619 }
3620
3621 /*************************************************************************
3622  *      @       [SHLWAPI.378]
3623  *
3624  * Unicode version of MLLoadLibraryA.
3625  */
3626 HMODULE WINAPI MLLoadLibraryW(LPCWSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3627 {
3628     WCHAR mod_path[2*MAX_PATH];
3629     LPWSTR ptr;
3630     DWORD len;
3631
3632     FIXME("(%s,%p,%d) semi-stub!\n", debugstr_w(new_mod), inst_hwnd, dwCrossCodePage);
3633     len = GetModuleFileNameW(inst_hwnd, mod_path, sizeof(mod_path) / sizeof(WCHAR));
3634     if (!len || len >= sizeof(mod_path) / sizeof(WCHAR)) return NULL;
3635
3636     ptr = strrchrW(mod_path, '\\');
3637     if (ptr) {
3638         strcpyW(ptr+1, new_mod);
3639         TRACE("loading %s\n", debugstr_w(mod_path));
3640         return LoadLibraryW(mod_path);
3641     }
3642     return NULL;
3643 }
3644
3645 /*************************************************************************
3646  * ColorAdjustLuma      [SHLWAPI.@]
3647  *
3648  * Adjust the luminosity of a color
3649  *
3650  * PARAMS
3651  *  cRGB         [I] RGB value to convert
3652  *  dwLuma       [I] Luma adjustment
3653  *  bUnknown     [I] Unknown
3654  *
3655  * RETURNS
3656  *  The adjusted RGB color.
3657  */
3658 COLORREF WINAPI ColorAdjustLuma(COLORREF cRGB, int dwLuma, BOOL bUnknown)
3659 {
3660   TRACE("(0x%8x,%d,%d)\n", cRGB, dwLuma, bUnknown);
3661
3662   if (dwLuma)
3663   {
3664     WORD wH, wL, wS;
3665
3666     ColorRGBToHLS(cRGB, &wH, &wL, &wS);
3667
3668     FIXME("Ignoring luma adjustment\n");
3669
3670     /* FIXME: The adjustment is not linear */
3671
3672     cRGB = ColorHLSToRGB(wH, wL, wS);
3673   }
3674   return cRGB;
3675 }
3676
3677 /*************************************************************************
3678  *      @       [SHLWAPI.389]
3679  *
3680  * See GetSaveFileNameW.
3681  */
3682 BOOL WINAPI GetSaveFileNameWrapW(LPOPENFILENAMEW ofn)
3683 {
3684     return GetSaveFileNameW(ofn);
3685 }
3686
3687 /*************************************************************************
3688  *      @       [SHLWAPI.390]
3689  *
3690  * See WNetRestoreConnectionW.
3691  */
3692 DWORD WINAPI WNetRestoreConnectionWrapW(HWND hwndOwner, LPWSTR lpszDevice)
3693 {
3694     return WNetRestoreConnectionW(hwndOwner, lpszDevice);
3695 }
3696
3697 /*************************************************************************
3698  *      @       [SHLWAPI.391]
3699  *
3700  * See WNetGetLastErrorW.
3701  */
3702 DWORD WINAPI WNetGetLastErrorWrapW(LPDWORD lpError, LPWSTR lpErrorBuf, DWORD nErrorBufSize,
3703                          LPWSTR lpNameBuf, DWORD nNameBufSize)
3704 {
3705     return WNetGetLastErrorW(lpError, lpErrorBuf, nErrorBufSize, lpNameBuf, nNameBufSize);
3706 }
3707
3708 /*************************************************************************
3709  *      @       [SHLWAPI.401]
3710  *
3711  * See PageSetupDlgW.
3712  */
3713 BOOL WINAPI PageSetupDlgWrapW(LPPAGESETUPDLGW pagedlg)
3714 {
3715     return PageSetupDlgW(pagedlg);
3716 }
3717
3718 /*************************************************************************
3719  *      @       [SHLWAPI.402]
3720  *
3721  * See PrintDlgW.
3722  */
3723 BOOL WINAPI PrintDlgWrapW(LPPRINTDLGW printdlg)
3724 {
3725     return PrintDlgW(printdlg);
3726 }
3727
3728 /*************************************************************************
3729  *      @       [SHLWAPI.403]
3730  *
3731  * See GetOpenFileNameW.
3732  */
3733 BOOL WINAPI GetOpenFileNameWrapW(LPOPENFILENAMEW ofn)
3734 {
3735     return GetOpenFileNameW(ofn);
3736 }
3737
3738 /*************************************************************************
3739  *      @       [SHLWAPI.404]
3740  */
3741 HRESULT WINAPI SHIShellFolder_EnumObjects(LPSHELLFOLDER lpFolder, HWND hwnd, SHCONTF flags, IEnumIDList **ppenum)
3742 {
3743     /* Windows attempts to get an IPersist interface and, if that fails, an
3744      * IPersistFolder interface on the folder passed-in here.  If one of those
3745      * interfaces is available, it then calls GetClassID on the folder... and
3746      * then calls IShellFolder_EnumObjects no matter what, even crashing if
3747      * lpFolder isn't actually an IShellFolder object.  The purpose of getting
3748      * the ClassID is unknown, so we don't do it here.
3749      *
3750      * For discussion and detailed tests, see:
3751      * "shlwapi: Be less strict on which type of IShellFolder can be enumerated"
3752      * wine-devel mailing list, 3 Jun 2010
3753      */
3754
3755     return IShellFolder_EnumObjects(lpFolder, hwnd, flags, ppenum);
3756 }
3757
3758 /* INTERNAL: Map from HLS color space to RGB */
3759 static WORD ConvertHue(int wHue, WORD wMid1, WORD wMid2)
3760 {
3761   wHue = wHue > 240 ? wHue - 240 : wHue < 0 ? wHue + 240 : wHue;
3762
3763   if (wHue > 160)
3764     return wMid1;
3765   else if (wHue > 120)
3766     wHue = 160 - wHue;
3767   else if (wHue > 40)
3768     return wMid2;
3769
3770   return ((wHue * (wMid2 - wMid1) + 20) / 40) + wMid1;
3771 }
3772
3773 /* Convert to RGB and scale into RGB range (0..255) */
3774 #define GET_RGB(h) (ConvertHue(h, wMid1, wMid2) * 255 + 120) / 240
3775
3776 /*************************************************************************
3777  *      ColorHLSToRGB   [SHLWAPI.@]
3778  *
3779  * Convert from hls color space into an rgb COLORREF.
3780  *
3781  * PARAMS
3782  *  wHue        [I] Hue amount
3783  *  wLuminosity [I] Luminosity amount
3784  *  wSaturation [I] Saturation amount
3785  *
3786  * RETURNS
3787  *  A COLORREF representing the converted color.
3788  *
3789  * NOTES
3790  *  Input hls values are constrained to the range (0..240).
3791  */
3792 COLORREF WINAPI ColorHLSToRGB(WORD wHue, WORD wLuminosity, WORD wSaturation)
3793 {
3794   WORD wRed;
3795
3796   if (wSaturation)
3797   {
3798     WORD wGreen, wBlue, wMid1, wMid2;
3799
3800     if (wLuminosity > 120)
3801       wMid2 = wSaturation + wLuminosity - (wSaturation * wLuminosity + 120) / 240;
3802     else
3803       wMid2 = ((wSaturation + 240) * wLuminosity + 120) / 240;
3804
3805     wMid1 = wLuminosity * 2 - wMid2;
3806
3807     wRed   = GET_RGB(wHue + 80);
3808     wGreen = GET_RGB(wHue);
3809     wBlue  = GET_RGB(wHue - 80);
3810
3811     return RGB(wRed, wGreen, wBlue);
3812   }
3813
3814   wRed = wLuminosity * 255 / 240;
3815   return RGB(wRed, wRed, wRed);
3816 }
3817
3818 /*************************************************************************
3819  *      @       [SHLWAPI.413]
3820  *
3821  * Get the current docking status of the system.
3822  *
3823  * PARAMS
3824  *  dwFlags [I] DOCKINFO_ flags from "winbase.h", unused
3825  *
3826  * RETURNS
3827  *  One of DOCKINFO_UNDOCKED, DOCKINFO_UNDOCKED, or 0 if the system is not
3828  *  a notebook.
3829  */
3830 DWORD WINAPI SHGetMachineInfo(DWORD dwFlags)
3831 {
3832   HW_PROFILE_INFOA hwInfo;
3833
3834   TRACE("(0x%08x)\n", dwFlags);
3835
3836   GetCurrentHwProfileA(&hwInfo);
3837   switch (hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED))
3838   {
3839   case DOCKINFO_DOCKED:
3840   case DOCKINFO_UNDOCKED:
3841     return hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED);
3842   default:
3843     return 0;
3844   }
3845 }
3846
3847 /*************************************************************************
3848  *      @       [SHLWAPI.418]
3849  *
3850  * Function seems to do FreeLibrary plus other things.
3851  *
3852  * FIXME native shows the following calls:
3853  *   RtlEnterCriticalSection
3854  *   LocalFree
3855  *   GetProcAddress(Comctl32??, 150L)
3856  *   DPA_DeletePtr
3857  *   RtlLeaveCriticalSection
3858  *  followed by the FreeLibrary.
3859  *  The above code may be related to .377 above.
3860  */
3861 BOOL WINAPI MLFreeLibrary(HMODULE hModule)
3862 {
3863         FIXME("(%p) semi-stub\n", hModule);
3864         return FreeLibrary(hModule);
3865 }
3866
3867 /*************************************************************************
3868  *      @       [SHLWAPI.419]
3869  */
3870 BOOL WINAPI SHFlushSFCacheWrap(void) {
3871   FIXME(": stub\n");
3872   return TRUE;
3873 }
3874
3875 /*************************************************************************
3876  *      @      [SHLWAPI.429]
3877  * FIXME I have no idea what this function does or what its arguments are.
3878  */
3879 BOOL WINAPI MLIsMLHInstance(HINSTANCE hInst)
3880 {
3881        FIXME("(%p) stub\n", hInst);
3882        return FALSE;
3883 }
3884
3885
3886 /*************************************************************************
3887  *      @       [SHLWAPI.430]
3888  */
3889 DWORD WINAPI MLSetMLHInstance(HINSTANCE hInst, HANDLE hHeap)
3890 {
3891         FIXME("(%p,%p) stub\n", hInst, hHeap);
3892         return E_FAIL;   /* This is what is used if shlwapi not loaded */
3893 }
3894
3895 /*************************************************************************
3896  *      @       [SHLWAPI.431]
3897  */
3898 DWORD WINAPI MLClearMLHInstance(DWORD x)
3899 {
3900         FIXME("(0x%08x)stub\n", x);
3901         return 0xabba1247;
3902 }
3903
3904 /*************************************************************************
3905  * @ [SHLWAPI.432]
3906  *
3907  * See SHSendMessageBroadcastW
3908  *
3909  */
3910 DWORD WINAPI SHSendMessageBroadcastA(UINT uMsg, WPARAM wParam, LPARAM lParam)
3911 {
3912     return SendMessageTimeoutA(HWND_BROADCAST, uMsg, wParam, lParam,
3913                                SMTO_ABORTIFHUNG, 2000, NULL);
3914 }
3915
3916 /*************************************************************************
3917  * @ [SHLWAPI.433]
3918  *
3919  * A wrapper for sending Broadcast Messages to all top level Windows
3920  *
3921  */
3922 DWORD WINAPI SHSendMessageBroadcastW(UINT uMsg, WPARAM wParam, LPARAM lParam)
3923 {
3924     return SendMessageTimeoutW(HWND_BROADCAST, uMsg, wParam, lParam,
3925                                SMTO_ABORTIFHUNG, 2000, NULL);
3926 }
3927
3928 /*************************************************************************
3929  *      @       [SHLWAPI.436]
3930  *
3931  * Convert a Unicode string CLSID into a CLSID.
3932  *
3933  * PARAMS
3934  *  idstr      [I]   string containing a CLSID in text form
3935  *  id         [O]   CLSID extracted from the string
3936  *
3937  * RETURNS
3938  *  S_OK on success or E_INVALIDARG on failure
3939  */
3940 HRESULT WINAPI CLSIDFromStringWrap(LPCWSTR idstr, CLSID *id)
3941 {
3942     return CLSIDFromString((LPCOLESTR)idstr, id);
3943 }
3944
3945 /*************************************************************************
3946  *      @       [SHLWAPI.437]
3947  *
3948  * Determine if the OS supports a given feature.
3949  *
3950  * PARAMS
3951  *  dwFeature [I] Feature requested (undocumented)
3952  *
3953  * RETURNS
3954  *  TRUE  If the feature is available.
3955  *  FALSE If the feature is not available.
3956  */
3957 BOOL WINAPI IsOS(DWORD feature)
3958 {
3959     OSVERSIONINFOA osvi;
3960     DWORD platform, majorv, minorv;
3961
3962     osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOA);
3963     if(!GetVersionExA(&osvi))  {
3964         ERR("GetVersionEx failed\n");
3965         return FALSE;
3966     }
3967
3968     majorv = osvi.dwMajorVersion;
3969     minorv = osvi.dwMinorVersion;
3970     platform = osvi.dwPlatformId;
3971
3972 #define ISOS_RETURN(x) \
3973     TRACE("(0x%x) ret=%d\n",feature,(x)); \
3974     return (x);
3975
3976     switch(feature)  {
3977     case OS_WIN32SORGREATER:
3978         ISOS_RETURN(platform == VER_PLATFORM_WIN32s
3979                  || platform == VER_PLATFORM_WIN32_WINDOWS)
3980     case OS_NT:
3981         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3982     case OS_WIN95ORGREATER:
3983         ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS)
3984     case OS_NT4ORGREATER:
3985         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 4)
3986     case OS_WIN2000ORGREATER_ALT:
3987     case OS_WIN2000ORGREATER:
3988         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3989     case OS_WIN98ORGREATER:
3990         ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 10)
3991     case OS_WIN98_GOLD:
3992         ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 10)
3993     case OS_WIN2000PRO:
3994         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3995     case OS_WIN2000SERVER:
3996         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3997     case OS_WIN2000ADVSERVER:
3998         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3999     case OS_WIN2000DATACENTER:
4000         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
4001     case OS_WIN2000TERMINAL:
4002         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
4003     case OS_EMBEDDED:
4004         FIXME("(OS_EMBEDDED) What should we return here?\n");
4005         return FALSE;
4006     case OS_TERMINALCLIENT:
4007         FIXME("(OS_TERMINALCLIENT) What should we return here?\n");
4008         return FALSE;
4009     case OS_TERMINALREMOTEADMIN:
4010         FIXME("(OS_TERMINALREMOTEADMIN) What should we return here?\n");
4011         return FALSE;
4012     case OS_WIN95_GOLD:
4013         ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 0)
4014     case OS_MEORGREATER:
4015         ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 90)
4016     case OS_XPORGREATER:
4017         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
4018     case OS_HOME:
4019         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
4020     case OS_PROFESSIONAL:
4021         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4022     case OS_DATACENTER:
4023         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4024     case OS_ADVSERVER:
4025         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
4026     case OS_SERVER:
4027         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4028     case OS_TERMINALSERVER:
4029         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4030     case OS_PERSONALTERMINALSERVER:
4031         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && minorv >= 1 && majorv >= 5)
4032     case OS_FASTUSERSWITCHING:
4033         FIXME("(OS_FASTUSERSWITCHING) What should we return here?\n");
4034         return TRUE;
4035     case OS_WELCOMELOGONUI:
4036         FIXME("(OS_WELCOMELOGONUI) What should we return here?\n");
4037         return FALSE;
4038     case OS_DOMAINMEMBER:
4039         FIXME("(OS_DOMAINMEMBER) What should we return here?\n");
4040         return TRUE;
4041     case OS_ANYSERVER:
4042         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4043     case OS_WOW6432:
4044         FIXME("(OS_WOW6432) Should we check this?\n");
4045         return FALSE;
4046     case OS_WEBSERVER:
4047         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4048     case OS_SMALLBUSINESSSERVER:
4049         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4050     case OS_TABLETPC:
4051         FIXME("(OS_TABLEPC) What should we return here?\n");
4052         return FALSE;
4053     case OS_SERVERADMINUI:
4054         FIXME("(OS_SERVERADMINUI) What should we return here?\n");
4055         return FALSE;
4056     case OS_MEDIACENTER:
4057         FIXME("(OS_MEDIACENTER) What should we return here?\n");
4058         return FALSE;
4059     case OS_APPLIANCE:
4060         FIXME("(OS_APPLIANCE) What should we return here?\n");
4061         return FALSE;
4062     case 0x25: /*OS_VISTAORGREATER*/
4063         ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 6)
4064     }
4065
4066 #undef ISOS_RETURN
4067
4068     WARN("(0x%x) unknown parameter\n",feature);
4069
4070     return FALSE;
4071 }
4072
4073 /*************************************************************************
4074  * @  [SHLWAPI.439]
4075  */
4076 HRESULT WINAPI SHLoadRegUIStringW(HKEY hkey, LPCWSTR value, LPWSTR buf, DWORD size)
4077 {
4078     DWORD type, sz = size;
4079
4080     if(RegQueryValueExW(hkey, value, NULL, &type, (LPBYTE)buf, &sz) != ERROR_SUCCESS)
4081         return E_FAIL;
4082
4083     return SHLoadIndirectString(buf, buf, size, NULL);
4084 }
4085
4086 /*************************************************************************
4087  * @  [SHLWAPI.478]
4088  *
4089  * Call IInputObject_TranslateAcceleratorIO() on an object.
4090  *
4091  * PARAMS
4092  *  lpUnknown [I] Object supporting the IInputObject interface.
4093  *  lpMsg     [I] Key message to be processed.
4094  *
4095  * RETURNS
4096  *  Success: S_OK.
4097  *  Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
4098  */
4099 HRESULT WINAPI IUnknown_TranslateAcceleratorIO(IUnknown *lpUnknown, LPMSG lpMsg)
4100 {
4101   IInputObject* lpInput = NULL;
4102   HRESULT hRet = E_INVALIDARG;
4103
4104   TRACE("(%p,%p)\n", lpUnknown, lpMsg);
4105   if (lpUnknown)
4106   {
4107     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
4108                                    (void**)&lpInput);
4109     if (SUCCEEDED(hRet) && lpInput)
4110     {
4111       hRet = IInputObject_TranslateAcceleratorIO(lpInput, lpMsg);
4112       IInputObject_Release(lpInput);
4113     }
4114   }
4115   return hRet;
4116 }
4117
4118 /*************************************************************************
4119  * @  [SHLWAPI.481]
4120  *
4121  * Call IInputObject_HasFocusIO() on an object.
4122  *
4123  * PARAMS
4124  *  lpUnknown [I] Object supporting the IInputObject interface.
4125  *
4126  * RETURNS
4127  *  Success: S_OK, if lpUnknown is an IInputObject object and has the focus,
4128  *           or S_FALSE otherwise.
4129  *  Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
4130  */
4131 HRESULT WINAPI IUnknown_HasFocusIO(IUnknown *lpUnknown)
4132 {
4133   IInputObject* lpInput = NULL;
4134   HRESULT hRet = E_INVALIDARG;
4135
4136   TRACE("(%p)\n", lpUnknown);
4137   if (lpUnknown)
4138   {
4139     hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
4140                                    (void**)&lpInput);
4141     if (SUCCEEDED(hRet) && lpInput)
4142     {
4143       hRet = IInputObject_HasFocusIO(lpInput);
4144       IInputObject_Release(lpInput);
4145     }
4146   }
4147   return hRet;
4148 }
4149
4150 /*************************************************************************
4151  *      ColorRGBToHLS   [SHLWAPI.@]
4152  *
4153  * Convert an rgb COLORREF into the hls color space.
4154  *
4155  * PARAMS
4156  *  cRGB         [I] Source rgb value
4157  *  pwHue        [O] Destination for converted hue
4158  *  pwLuminance  [O] Destination for converted luminance
4159  *  pwSaturation [O] Destination for converted saturation
4160  *
4161  * RETURNS
4162  *  Nothing. pwHue, pwLuminance and pwSaturation are set to the converted
4163  *  values.
4164  *
4165  * NOTES
4166  *  Output HLS values are constrained to the range (0..240).
4167  *  For Achromatic conversions, Hue is set to 160.
4168  */
4169 VOID WINAPI ColorRGBToHLS(COLORREF cRGB, LPWORD pwHue,
4170                           LPWORD pwLuminance, LPWORD pwSaturation)
4171 {
4172   int wR, wG, wB, wMax, wMin, wHue, wLuminosity, wSaturation;
4173
4174   TRACE("(%08x,%p,%p,%p)\n", cRGB, pwHue, pwLuminance, pwSaturation);
4175
4176   wR = GetRValue(cRGB);
4177   wG = GetGValue(cRGB);
4178   wB = GetBValue(cRGB);
4179
4180   wMax = max(wR, max(wG, wB));
4181   wMin = min(wR, min(wG, wB));
4182
4183   /* Luminosity */
4184   wLuminosity = ((wMax + wMin) * 240 + 255) / 510;
4185
4186   if (wMax == wMin)
4187   {
4188     /* Achromatic case */
4189     wSaturation = 0;
4190     /* Hue is now unrepresentable, but this is what native returns... */
4191     wHue = 160;
4192   }
4193   else
4194   {
4195     /* Chromatic case */
4196     int wDelta = wMax - wMin, wRNorm, wGNorm, wBNorm;
4197
4198     /* Saturation */
4199     if (wLuminosity <= 120)
4200       wSaturation = ((wMax + wMin)/2 + wDelta * 240) / (wMax + wMin);
4201     else
4202       wSaturation = ((510 - wMax - wMin)/2 + wDelta * 240) / (510 - wMax - wMin);
4203
4204     /* Hue */
4205     wRNorm = (wDelta/2 + wMax * 40 - wR * 40) / wDelta;
4206     wGNorm = (wDelta/2 + wMax * 40 - wG * 40) / wDelta;
4207     wBNorm = (wDelta/2 + wMax * 40 - wB * 40) / wDelta;
4208
4209     if (wR == wMax)
4210       wHue = wBNorm - wGNorm;
4211     else if (wG == wMax)
4212       wHue = 80 + wRNorm - wBNorm;
4213     else
4214       wHue = 160 + wGNorm - wRNorm;
4215     if (wHue < 0)
4216       wHue += 240;
4217     else if (wHue > 240)
4218       wHue -= 240;
4219   }
4220   if (pwHue)
4221     *pwHue = wHue;
4222   if (pwLuminance)
4223     *pwLuminance = wLuminosity;
4224   if (pwSaturation)
4225     *pwSaturation = wSaturation;
4226 }
4227
4228 /*************************************************************************
4229  *      SHCreateShellPalette    [SHLWAPI.@]
4230  */
4231 HPALETTE WINAPI SHCreateShellPalette(HDC hdc)
4232 {
4233         FIXME("stub\n");
4234         return CreateHalftonePalette(hdc);
4235 }
4236
4237 /*************************************************************************
4238  *      SHGetInverseCMAP (SHLWAPI.@)
4239  *
4240  * Get an inverse color map table.
4241  *
4242  * PARAMS
4243  *  lpCmap  [O] Destination for color map
4244  *  dwSize  [I] Size of memory pointed to by lpCmap
4245  *
4246  * RETURNS
4247  *  Success: S_OK.
4248  *  Failure: E_POINTER,    If lpCmap is invalid.
4249  *           E_INVALIDARG, If dwFlags is invalid
4250  *           E_OUTOFMEMORY, If there is no memory available
4251  *
4252  * NOTES
4253  *  dwSize may only be CMAP_PTR_SIZE (4) or CMAP_SIZE (8192).
4254  *  If dwSize = CMAP_PTR_SIZE, *lpCmap is set to the address of this DLL's
4255  *  internal CMap.
4256  *  If dwSize = CMAP_SIZE, lpCmap is filled with a copy of the data from
4257  *  this DLL's internal CMap.
4258  */
4259 HRESULT WINAPI SHGetInverseCMAP(LPDWORD dest, DWORD dwSize)
4260 {
4261     if (dwSize == 4) {
4262         FIXME(" - returning bogus address for SHGetInverseCMAP\n");
4263         *dest = (DWORD)0xabba1249;
4264         return 0;
4265     }
4266     FIXME("(%p, %#x) stub\n", dest, dwSize);
4267     return 0;
4268 }
4269
4270 /*************************************************************************
4271  *      SHIsLowMemoryMachine    [SHLWAPI.@]
4272  *
4273  * Determine if the current computer has low memory.
4274  *
4275  * PARAMS
4276  *  x [I] FIXME
4277  *
4278  * RETURNS
4279  *  TRUE if the users machine has 16 Megabytes of memory or less,
4280  *  FALSE otherwise.
4281  */
4282 BOOL WINAPI SHIsLowMemoryMachine (DWORD x)
4283 {
4284   FIXME("(0x%08x) stub\n", x);
4285   return FALSE;
4286 }
4287
4288 /*************************************************************************
4289  *      GetMenuPosFromID        [SHLWAPI.@]
4290  *
4291  * Return the position of a menu item from its Id.
4292  *
4293  * PARAMS
4294  *   hMenu [I] Menu containing the item
4295  *   wID   [I] Id of the menu item
4296  *
4297  * RETURNS
4298  *  Success: The index of the menu item in hMenu.
4299  *  Failure: -1, If the item is not found.
4300  */
4301 INT WINAPI GetMenuPosFromID(HMENU hMenu, UINT wID)
4302 {
4303     MENUITEMINFOW mi;
4304     INT nCount = GetMenuItemCount(hMenu), nIter = 0;
4305
4306     TRACE("%p %u\n", hMenu, wID);
4307
4308     while (nIter < nCount)
4309     {
4310         mi.cbSize = sizeof(mi);
4311         mi.fMask = MIIM_ID;
4312         if (GetMenuItemInfoW(hMenu, nIter, TRUE, &mi) && mi.wID == wID)
4313         {
4314             TRACE("ret %d\n", nIter);
4315             return nIter;
4316         }
4317         nIter++;
4318     }
4319
4320     return -1;
4321 }
4322
4323 /*************************************************************************
4324  *      @       [SHLWAPI.179]
4325  *
4326  * Same as SHLWAPI.GetMenuPosFromID
4327  */
4328 DWORD WINAPI SHMenuIndexFromID(HMENU hMenu, UINT uID)
4329 {
4330     TRACE("%p %u\n", hMenu, uID);
4331     return GetMenuPosFromID(hMenu, uID);
4332 }
4333
4334
4335 /*************************************************************************
4336  *      @       [SHLWAPI.448]
4337  */
4338 VOID WINAPI FixSlashesAndColonW(LPWSTR lpwstr)
4339 {
4340     while (*lpwstr)
4341     {
4342         if (*lpwstr == '/')
4343             *lpwstr = '\\';
4344         lpwstr++;
4345     }
4346 }
4347
4348
4349 /*************************************************************************
4350  *      @       [SHLWAPI.461]
4351  */
4352 DWORD WINAPI SHGetAppCompatFlags(DWORD dwUnknown)
4353 {
4354   FIXME("(0x%08x) stub\n", dwUnknown);
4355   return 0;
4356 }
4357
4358
4359 /*************************************************************************
4360  *      @       [SHLWAPI.549]
4361  */
4362 HRESULT WINAPI SHCoCreateInstanceAC(REFCLSID rclsid, LPUNKNOWN pUnkOuter,
4363                                     DWORD dwClsContext, REFIID iid, LPVOID *ppv)
4364 {
4365     return CoCreateInstance(rclsid, pUnkOuter, dwClsContext, iid, ppv);
4366 }
4367
4368 /*************************************************************************
4369  * SHSkipJunction       [SHLWAPI.@]
4370  *
4371  * Determine if a bind context can be bound to an object
4372  *
4373  * PARAMS
4374  *  pbc    [I] Bind context to check
4375  *  pclsid [I] CLSID of object to be bound to
4376  *
4377  * RETURNS
4378  *  TRUE: If it is safe to bind
4379  *  FALSE: If pbc is invalid or binding would not be safe
4380  *
4381  */
4382 BOOL WINAPI SHSkipJunction(IBindCtx *pbc, const CLSID *pclsid)
4383 {
4384   static WCHAR szSkipBinding[] = { 'S','k','i','p',' ',
4385     'B','i','n','d','i','n','g',' ','C','L','S','I','D','\0' };
4386   BOOL bRet = FALSE;
4387
4388   if (pbc)
4389   {
4390     IUnknown* lpUnk;
4391
4392     if (SUCCEEDED(IBindCtx_GetObjectParam(pbc, szSkipBinding, &lpUnk)))
4393     {
4394       CLSID clsid;
4395
4396       if (SUCCEEDED(IUnknown_GetClassID(lpUnk, &clsid)) &&
4397           IsEqualGUID(pclsid, &clsid))
4398         bRet = TRUE;
4399
4400       IUnknown_Release(lpUnk);
4401     }
4402   }
4403   return bRet;
4404 }
4405
4406 /***********************************************************************
4407  *              SHGetShellKey (SHLWAPI.491)
4408  */
4409 HKEY WINAPI SHGetShellKey(DWORD flags, LPCWSTR sub_key, BOOL create)
4410 {
4411     enum _shellkey_flags {
4412         SHKEY_Root_HKCU = 0x1,
4413         SHKEY_Root_HKLM = 0x2,
4414         SHKEY_Key_Explorer  = 0x00,
4415         SHKEY_Key_Shell = 0x10,
4416         SHKEY_Key_ShellNoRoam = 0x20,
4417         SHKEY_Key_Classes = 0x30,
4418         SHKEY_Subkey_Default = 0x0000,
4419         SHKEY_Subkey_ResourceName = 0x1000,
4420         SHKEY_Subkey_Handlers = 0x2000,
4421         SHKEY_Subkey_Associations = 0x3000,
4422         SHKEY_Subkey_Volatile = 0x4000,
4423         SHKEY_Subkey_MUICache = 0x5000,
4424         SHKEY_Subkey_FileExts = 0x6000
4425     };
4426
4427     static const WCHAR explorerW[] = {'S','o','f','t','w','a','r','e','\\',
4428         'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
4429         'C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\',
4430         'E','x','p','l','o','r','e','r','\\'};
4431     static const WCHAR shellW[] = {'S','o','f','t','w','a','r','e','\\',
4432         'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
4433         'S','h','e','l','l','\\'};
4434     static const WCHAR shell_no_roamW[] = {'S','o','f','t','w','a','r','e','\\',
4435         'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
4436         'S','h','e','l','l','N','o','R','o','a','m','\\'};
4437     static const WCHAR classesW[] = {'S','o','f','t','w','a','r','e','\\',
4438         'C','l','a','s','s','e','s','\\'};
4439
4440     static const WCHAR localized_resource_nameW[] = {'L','o','c','a','l','i','z','e','d',
4441         'R','e','s','o','u','r','c','e','N','a','m','e','\\'};
4442     static const WCHAR handlersW[] = {'H','a','n','d','l','e','r','s','\\'};
4443     static const WCHAR associationsW[] = {'A','s','s','o','c','i','a','t','i','o','n','s','\\'};
4444     static const WCHAR volatileW[] = {'V','o','l','a','t','i','l','e','\\'};
4445     static const WCHAR mui_cacheW[] = {'M','U','I','C','a','c','h','e','\\'};
4446     static const WCHAR file_extsW[] = {'F','i','l','e','E','x','t','s','\\'};
4447
4448     WCHAR *path;
4449     const WCHAR *key, *subkey;
4450     int size_key, size_subkey, size_user;
4451     HKEY hkey = NULL;
4452
4453     TRACE("(0x%08x, %s, %d)\n", flags, debugstr_w(sub_key), create);
4454
4455     /* For compatibility with Vista+ */
4456     if(flags == 0x1ffff)
4457         flags = 0x21;
4458
4459     switch(flags&0xff0) {
4460     case SHKEY_Key_Explorer:
4461         key = explorerW;
4462         size_key = sizeof(explorerW);
4463         break;
4464     case SHKEY_Key_Shell:
4465         key = shellW;
4466         size_key = sizeof(shellW);
4467         break;
4468     case SHKEY_Key_ShellNoRoam:
4469         key = shell_no_roamW;
4470         size_key = sizeof(shell_no_roamW);
4471         break;
4472     case SHKEY_Key_Classes:
4473         key = classesW;
4474         size_key = sizeof(classesW);
4475         break;
4476     default:
4477         FIXME("unsupported flags (0x%08x)\n", flags);
4478         return NULL;
4479     }
4480
4481     switch(flags&0xff000) {
4482     case SHKEY_Subkey_Default:
4483         subkey = NULL;
4484         size_subkey = 0;
4485         break;
4486     case SHKEY_Subkey_ResourceName:
4487         subkey = localized_resource_nameW;
4488         size_subkey = sizeof(localized_resource_nameW);
4489         break;
4490     case SHKEY_Subkey_Handlers:
4491         subkey = handlersW;
4492         size_subkey = sizeof(handlersW);
4493         break;
4494     case SHKEY_Subkey_Associations:
4495         subkey = associationsW;
4496         size_subkey = sizeof(associationsW);
4497         break;
4498     case SHKEY_Subkey_Volatile:
4499         subkey = volatileW;
4500         size_subkey = sizeof(volatileW);
4501         break;
4502     case SHKEY_Subkey_MUICache:
4503         subkey = mui_cacheW;
4504         size_subkey = sizeof(mui_cacheW);
4505         break;
4506     case SHKEY_Subkey_FileExts:
4507         subkey = file_extsW;
4508         size_subkey = sizeof(file_extsW);
4509         break;
4510     default:
4511         FIXME("unsupported flags (0x%08x)\n", flags);
4512         return NULL;
4513     }
4514
4515     if(sub_key)
4516         size_user = lstrlenW(sub_key)*sizeof(WCHAR);
4517     else
4518         size_user = 0;
4519
4520     path = HeapAlloc(GetProcessHeap(), 0, size_key+size_subkey+size_user+sizeof(WCHAR));
4521     if(!path) {
4522         ERR("Out of memory\n");
4523         return NULL;
4524     }
4525
4526     memcpy(path, key, size_key);
4527     if(subkey)
4528         memcpy(path+size_key/sizeof(WCHAR), subkey, size_subkey);
4529     if(sub_key)
4530         memcpy(path+(size_key+size_subkey)/sizeof(WCHAR), sub_key, size_user);
4531     path[(size_key+size_subkey+size_user)/sizeof(WCHAR)] = '\0';
4532
4533     if(create)
4534         RegCreateKeyExW((flags&0xf)==SHKEY_Root_HKLM?HKEY_LOCAL_MACHINE:HKEY_CURRENT_USER,
4535                 path, 0, NULL, 0, MAXIMUM_ALLOWED, NULL, &hkey, NULL);
4536     else
4537         RegOpenKeyExW((flags&0xf)==SHKEY_Root_HKLM?HKEY_LOCAL_MACHINE:HKEY_CURRENT_USER,
4538                 path, 0, MAXIMUM_ALLOWED, &hkey);
4539
4540     HeapFree(GetProcessHeap(), 0, path);
4541     return hkey;
4542 }
4543
4544 /***********************************************************************
4545  *              SHQueueUserWorkItem (SHLWAPI.@)
4546  */
4547 BOOL WINAPI SHQueueUserWorkItem(LPTHREAD_START_ROUTINE pfnCallback, 
4548         LPVOID pContext, LONG lPriority, DWORD_PTR dwTag,
4549         DWORD_PTR *pdwId, LPCSTR pszModule, DWORD dwFlags)
4550 {
4551     TRACE("(%p, %p, %d, %lx, %p, %s, %08x)\n", pfnCallback, pContext,
4552           lPriority, dwTag, pdwId, debugstr_a(pszModule), dwFlags);
4553
4554     if(lPriority || dwTag || pdwId || pszModule || dwFlags)
4555         FIXME("Unsupported arguments\n");
4556
4557     return QueueUserWorkItem(pfnCallback, pContext, 0);
4558 }
4559
4560 /***********************************************************************
4561  *              SHSetTimerQueueTimer (SHLWAPI.263)
4562  */
4563 HANDLE WINAPI SHSetTimerQueueTimer(HANDLE hQueue,
4564         WAITORTIMERCALLBACK pfnCallback, LPVOID pContext, DWORD dwDueTime,
4565         DWORD dwPeriod, LPCSTR lpszLibrary, DWORD dwFlags)
4566 {
4567     HANDLE hNewTimer;
4568
4569     /* SHSetTimerQueueTimer flags -> CreateTimerQueueTimer flags */
4570     if (dwFlags & TPS_LONGEXECTIME) {
4571         dwFlags &= ~TPS_LONGEXECTIME;
4572         dwFlags |= WT_EXECUTELONGFUNCTION;
4573     }
4574     if (dwFlags & TPS_EXECUTEIO) {
4575         dwFlags &= ~TPS_EXECUTEIO;
4576         dwFlags |= WT_EXECUTEINIOTHREAD;
4577     }
4578
4579     if (!CreateTimerQueueTimer(&hNewTimer, hQueue, pfnCallback, pContext,
4580                                dwDueTime, dwPeriod, dwFlags))
4581         return NULL;
4582
4583     return hNewTimer;
4584 }
4585
4586 /***********************************************************************
4587  *              IUnknown_OnFocusChangeIS (SHLWAPI.@)
4588  */
4589 HRESULT WINAPI IUnknown_OnFocusChangeIS(LPUNKNOWN lpUnknown, LPUNKNOWN pFocusObject, BOOL bFocus)
4590 {
4591     IInputObjectSite *pIOS = NULL;
4592     HRESULT hRet = E_INVALIDARG;
4593
4594     TRACE("(%p, %p, %s)\n", lpUnknown, pFocusObject, bFocus ? "TRUE" : "FALSE");
4595
4596     if (lpUnknown)
4597     {
4598         hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObjectSite,
4599                                        (void **)&pIOS);
4600         if (SUCCEEDED(hRet) && pIOS)
4601         {
4602             hRet = IInputObjectSite_OnFocusChangeIS(pIOS, pFocusObject, bFocus);
4603             IInputObjectSite_Release(pIOS);
4604         }
4605     }
4606     return hRet;
4607 }
4608
4609 /***********************************************************************
4610  *              SKAllocValueW (SHLWAPI.519)
4611  */
4612 HRESULT WINAPI SKAllocValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value, DWORD *type,
4613         LPVOID *data, DWORD *count)
4614 {
4615     DWORD ret, size;
4616     HKEY hkey;
4617
4618     TRACE("(0x%x, %s, %s, %p, %p, %p)\n", flags, debugstr_w(subkey),
4619         debugstr_w(value), type, data, count);
4620
4621     hkey = SHGetShellKey(flags, subkey, FALSE);
4622     if (!hkey)
4623         return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4624
4625     ret = SHQueryValueExW(hkey, value, NULL, type, NULL, &size);
4626     if (ret) {
4627         RegCloseKey(hkey);
4628         return HRESULT_FROM_WIN32(ret);
4629     }
4630
4631     size += 2;
4632     *data = LocalAlloc(0, size);
4633     if (!*data) {
4634         RegCloseKey(hkey);
4635         return E_OUTOFMEMORY;
4636     }
4637
4638     ret = SHQueryValueExW(hkey, value, NULL, type, *data, &size);
4639     if (count)
4640         *count = size;
4641
4642     RegCloseKey(hkey);
4643     return HRESULT_FROM_WIN32(ret);
4644 }
4645
4646 /***********************************************************************
4647  *              SKDeleteValueW (SHLWAPI.518)
4648  */
4649 HRESULT WINAPI SKDeleteValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value)
4650 {
4651     DWORD ret;
4652     HKEY hkey;
4653
4654     TRACE("(0x%x, %s %s)\n", flags, debugstr_w(subkey), debugstr_w(value));
4655
4656     hkey = SHGetShellKey(flags, subkey, FALSE);
4657     if (!hkey)
4658         return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4659
4660     ret = RegDeleteValueW(hkey, value);
4661
4662     RegCloseKey(hkey);
4663     return HRESULT_FROM_WIN32(ret);
4664 }
4665
4666 /***********************************************************************
4667  *              SKGetValueW (SHLWAPI.516)
4668  */
4669 HRESULT WINAPI SKGetValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value, DWORD *type,
4670     void *data, DWORD *count)
4671 {
4672     DWORD ret;
4673     HKEY hkey;
4674
4675     TRACE("(0x%x, %s, %s, %p, %p, %p)\n", flags, debugstr_w(subkey),
4676         debugstr_w(value), type, data, count);
4677
4678     hkey = SHGetShellKey(flags, subkey, FALSE);
4679     if (!hkey)
4680         return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4681
4682     ret = SHQueryValueExW(hkey, value, NULL, type, data, count);
4683
4684     RegCloseKey(hkey);
4685     return HRESULT_FROM_WIN32(ret);
4686 }
4687
4688 /***********************************************************************
4689  *              SKSetValueW (SHLWAPI.516)
4690  */
4691 HRESULT WINAPI SKSetValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value,
4692         DWORD type, void *data, DWORD count)
4693 {
4694     DWORD ret;
4695     HKEY hkey;
4696
4697     TRACE("(0x%x, %s, %s, %x, %p, %d)\n", flags, debugstr_w(subkey),
4698             debugstr_w(value), type, data, count);
4699
4700     hkey = SHGetShellKey(flags, subkey, TRUE);
4701     if (!hkey)
4702         return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4703
4704     ret = RegSetValueExW(hkey, value, 0, type, data, count);
4705
4706     RegCloseKey(hkey);
4707     return HRESULT_FROM_WIN32(ret);
4708 }
4709
4710 typedef HRESULT (WINAPI *DllGetVersion_func)(DLLVERSIONINFO *);
4711
4712 /***********************************************************************
4713  *              GetUIVersion (SHLWAPI.452)
4714  */
4715 DWORD WINAPI GetUIVersion(void)
4716 {
4717     static DWORD version;
4718
4719     if (!version)
4720     {
4721         DllGetVersion_func pDllGetVersion;
4722         HMODULE dll = LoadLibraryA("shell32.dll");
4723         if (!dll) return 0;
4724
4725         pDllGetVersion = (DllGetVersion_func)GetProcAddress(dll, "DllGetVersion");
4726         if (pDllGetVersion)
4727         {
4728             DLLVERSIONINFO dvi;
4729             dvi.cbSize = sizeof(DLLVERSIONINFO);
4730             if (pDllGetVersion(&dvi) == S_OK) version = dvi.dwMajorVersion;
4731         }
4732         FreeLibrary( dll );
4733         if (!version) version = 3;  /* old shell dlls don't have DllGetVersion */
4734     }
4735     return version;
4736 }
4737
4738 /***********************************************************************
4739  *              ShellMessageBoxWrapW [SHLWAPI.388]
4740  *
4741  * See shell32.ShellMessageBoxW
4742  *
4743  * NOTE:
4744  * shlwapi.ShellMessageBoxWrapW is a duplicate of shell32.ShellMessageBoxW
4745  * because we can't forward to it in the .spec file since it's exported by
4746  * ordinal. If you change the implementation here please update the code in
4747  * shell32 as well.
4748  */
4749 INT WINAPIV ShellMessageBoxWrapW(HINSTANCE hInstance, HWND hWnd, LPCWSTR lpText,
4750                                  LPCWSTR lpCaption, UINT uType, ...)
4751 {
4752     WCHAR *szText = NULL, szTitle[100];
4753     LPCWSTR pszText, pszTitle = szTitle;
4754     LPWSTR pszTemp;
4755     __ms_va_list args;
4756     int ret;
4757
4758     __ms_va_start(args, uType);
4759
4760     TRACE("(%p,%p,%p,%p,%08x)\n", hInstance, hWnd, lpText, lpCaption, uType);
4761
4762     if (IS_INTRESOURCE(lpCaption))
4763         LoadStringW(hInstance, LOWORD(lpCaption), szTitle, sizeof(szTitle)/sizeof(szTitle[0]));
4764     else
4765         pszTitle = lpCaption;
4766
4767     if (IS_INTRESOURCE(lpText))
4768     {
4769         const WCHAR *ptr;
4770         UINT len = LoadStringW(hInstance, LOWORD(lpText), (LPWSTR)&ptr, 0);
4771
4772         if (len)
4773         {
4774             szText = HeapAlloc(GetProcessHeap(), 0, (len + 1) * sizeof(WCHAR));
4775             if (szText) LoadStringW(hInstance, LOWORD(lpText), szText, len + 1);
4776         }
4777         pszText = szText;
4778         if (!pszText) {
4779             WARN("Failed to load id %d\n", LOWORD(lpText));
4780             __ms_va_end(args);
4781             return 0;
4782         }
4783     }
4784     else
4785         pszText = lpText;
4786
4787     FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
4788                    pszText, 0, 0, (LPWSTR)&pszTemp, 0, &args);
4789
4790     __ms_va_end(args);
4791
4792     ret = MessageBoxW(hWnd, pszTemp, pszTitle, uType);
4793
4794     HeapFree(GetProcessHeap(), 0, szText);
4795     LocalFree(pszTemp);
4796     return ret;
4797 }
4798
4799 /***********************************************************************
4800  *              ZoneComputePaneSize [SHLWAPI.382]
4801  */
4802 UINT WINAPI ZoneComputePaneSize(HWND hwnd)
4803 {
4804     FIXME("\n");
4805     return 0x95;
4806 }
4807
4808 /***********************************************************************
4809  *              SHChangeNotifyWrap [SHLWAPI.394]
4810  */
4811 void WINAPI SHChangeNotifyWrap(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2)
4812 {
4813     SHChangeNotify(wEventId, uFlags, dwItem1, dwItem2);
4814 }
4815
4816 typedef struct SHELL_USER_SID {   /* according to MSDN this should be in shlobj.h... */
4817     SID_IDENTIFIER_AUTHORITY sidAuthority;
4818     DWORD                    dwUserGroupID;
4819     DWORD                    dwUserID;
4820 } SHELL_USER_SID, *PSHELL_USER_SID;
4821
4822 typedef struct SHELL_USER_PERMISSION { /* ...and this should be in shlwapi.h */
4823     SHELL_USER_SID susID;
4824     DWORD          dwAccessType;
4825     BOOL           fInherit;
4826     DWORD          dwAccessMask;
4827     DWORD          dwInheritMask;
4828     DWORD          dwInheritAccessMask;
4829 } SHELL_USER_PERMISSION, *PSHELL_USER_PERMISSION;
4830
4831 /***********************************************************************
4832  *             GetShellSecurityDescriptor [SHLWAPI.475]
4833  *
4834  * prepares SECURITY_DESCRIPTOR from a set of ACEs
4835  *
4836  * PARAMS
4837  *  apUserPerm [I] array of pointers to SHELL_USER_PERMISSION structures,
4838  *                 each of which describes permissions to apply
4839  *  cUserPerm  [I] number of entries in apUserPerm array
4840  *
4841  * RETURNS
4842  *  success: pointer to SECURITY_DESCRIPTOR
4843  *  failure: NULL
4844  *
4845  * NOTES
4846  *  Call should free returned descriptor with LocalFree
4847  */
4848 PSECURITY_DESCRIPTOR WINAPI GetShellSecurityDescriptor(PSHELL_USER_PERMISSION *apUserPerm, int cUserPerm)
4849 {
4850     PSID *sidlist;
4851     PSID  cur_user = NULL;
4852     BYTE  tuUser[2000];
4853     DWORD acl_size;
4854     int   sid_count, i;
4855     PSECURITY_DESCRIPTOR psd = NULL;
4856
4857     TRACE("%p %d\n", apUserPerm, cUserPerm);
4858
4859     if (apUserPerm == NULL || cUserPerm <= 0)
4860         return NULL;
4861
4862     sidlist = HeapAlloc(GetProcessHeap(), 0, cUserPerm * sizeof(PSID));
4863     if (!sidlist)
4864         return NULL;
4865
4866     acl_size = sizeof(ACL);
4867
4868     for(sid_count = 0; sid_count < cUserPerm; sid_count++)
4869     {
4870         static SHELL_USER_SID null_sid = {{SECURITY_NULL_SID_AUTHORITY}, 0, 0};
4871         PSHELL_USER_PERMISSION perm = apUserPerm[sid_count];
4872         PSHELL_USER_SID sid = &perm->susID;
4873         PSID pSid;
4874         BOOL ret = TRUE;
4875
4876         if (!memcmp((void*)sid, (void*)&null_sid, sizeof(SHELL_USER_SID)))
4877         {  /* current user's SID */ 
4878             if (!cur_user)
4879             {
4880                 HANDLE Token;
4881                 DWORD bufsize = sizeof(tuUser);
4882
4883                 ret = OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY, &Token);
4884                 if (ret)
4885                 {
4886                     ret = GetTokenInformation(Token, TokenUser, (void*)tuUser, bufsize, &bufsize );
4887                     if (ret)
4888                         cur_user = ((PTOKEN_USER)tuUser)->User.Sid;
4889                     CloseHandle(Token);
4890                 }
4891             }
4892             pSid = cur_user;
4893         } else if (sid->dwUserID==0) /* one sub-authority */
4894             ret = AllocateAndInitializeSid(&sid->sidAuthority, 1, sid->dwUserGroupID, 0,
4895                     0, 0, 0, 0, 0, 0, &pSid);
4896         else
4897             ret = AllocateAndInitializeSid(&sid->sidAuthority, 2, sid->dwUserGroupID, sid->dwUserID,
4898                     0, 0, 0, 0, 0, 0, &pSid);
4899         if (!ret)
4900             goto free_sids;
4901
4902         sidlist[sid_count] = pSid;
4903         /* increment acl_size (1 ACE for non-inheritable and 2 ACEs for inheritable records */
4904         acl_size += (sizeof(ACCESS_ALLOWED_ACE)-sizeof(DWORD) + GetLengthSid(pSid)) * (perm->fInherit ? 2 : 1);
4905     }
4906
4907     psd = LocalAlloc(0, sizeof(SECURITY_DESCRIPTOR) + acl_size);
4908
4909     if (psd != NULL)
4910     {
4911         PACL pAcl = (PACL)(((BYTE*)psd)+sizeof(SECURITY_DESCRIPTOR));
4912
4913         if (!InitializeSecurityDescriptor(psd, SECURITY_DESCRIPTOR_REVISION))
4914             goto error;
4915
4916         if (!InitializeAcl(pAcl, acl_size, ACL_REVISION))
4917             goto error;
4918
4919         for(i = 0; i < sid_count; i++)
4920         {
4921             PSHELL_USER_PERMISSION sup = apUserPerm[i];
4922             PSID sid = sidlist[i];
4923
4924             switch(sup->dwAccessType)
4925             {
4926                 case ACCESS_ALLOWED_ACE_TYPE:
4927                     if (!AddAccessAllowedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4928                         goto error;
4929                     if (sup->fInherit && !AddAccessAllowedAceEx(pAcl, ACL_REVISION, 
4930                                 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4931                         goto error;
4932                     break;
4933                 case ACCESS_DENIED_ACE_TYPE:
4934                     if (!AddAccessDeniedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4935                         goto error;
4936                     if (sup->fInherit && !AddAccessDeniedAceEx(pAcl, ACL_REVISION, 
4937                                 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4938                         goto error;
4939                     break;
4940                 default:
4941                     goto error;
4942             }
4943         }
4944
4945         if (!SetSecurityDescriptorDacl(psd, TRUE, pAcl, FALSE))
4946             goto error;
4947     }
4948     goto free_sids;
4949
4950 error:
4951     LocalFree(psd);
4952     psd = NULL;
4953 free_sids:
4954     for(i = 0; i < sid_count; i++)
4955     {
4956         if (!cur_user || sidlist[i] != cur_user)
4957             FreeSid(sidlist[i]);
4958     }
4959     HeapFree(GetProcessHeap(), 0, sidlist);
4960
4961     return psd;
4962 }
4963
4964 /***********************************************************************
4965  *             SHCreatePropertyBagOnRegKey [SHLWAPI.471]
4966  *
4967  * Creates a property bag from a registry key
4968  *
4969  * PARAMS
4970  *  hKey       [I] Handle to the desired registry key
4971  *  subkey     [I] Name of desired subkey, or NULL to open hKey directly
4972  *  grfMode    [I] Optional flags
4973  *  riid       [I] IID of requested property bag interface
4974  *  ppv        [O] Address to receive pointer to the new interface
4975  *
4976  * RETURNS
4977  *  success: 0
4978  *  failure: error code
4979  *
4980  */
4981 HRESULT WINAPI SHCreatePropertyBagOnRegKey (HKEY hKey, LPCWSTR subkey,
4982     DWORD grfMode, REFIID riid, void **ppv)
4983 {
4984     FIXME("%p %s %d %s %p STUB\n", hKey, debugstr_w(subkey), grfMode,
4985           debugstr_guid(riid), ppv);
4986
4987     return E_NOTIMPL;
4988 }
4989
4990 /***********************************************************************
4991  *             SHGetViewStatePropertyBag [SHLWAPI.515]
4992  *
4993  * Retrieves a property bag in which the view state information of a folder
4994  * can be stored.
4995  *
4996  * PARAMS
4997  *  pidl        [I] PIDL of the folder requested
4998  *  bag_name    [I] Name of the property bag requested
4999  *  flags       [I] Optional flags
5000  *  riid        [I] IID of requested property bag interface
5001  *  ppv         [O] Address to receive pointer to the new interface
5002  *
5003  * RETURNS
5004  *  success: S_OK
5005  *  failure: error code
5006  *
5007  */
5008 HRESULT WINAPI SHGetViewStatePropertyBag(LPCITEMIDLIST pidl, LPWSTR bag_name,
5009     DWORD flags, REFIID riid, void **ppv)
5010 {
5011     FIXME("%p %s %d %s %p STUB\n", pidl, debugstr_w(bag_name), flags,
5012           debugstr_guid(riid), ppv);
5013
5014     return E_NOTIMPL;
5015 }
5016
5017 /***********************************************************************
5018  *             SHFormatDateTimeW [SHLWAPI.354]
5019  *
5020  * Produces a string representation of a time.
5021  *
5022  * PARAMS
5023  *  fileTime   [I] Pointer to FILETIME structure specifying the time
5024  *  flags      [I] Flags specifying the desired output
5025  *  buf        [O] Pointer to buffer for output
5026  *  size       [I] Number of characters that can be contained in buffer
5027  *
5028  * RETURNS
5029  *  success: number of characters written to the buffer
5030  *  failure: 0
5031  *
5032  */
5033 INT WINAPI SHFormatDateTimeW(const FILETIME UNALIGNED *fileTime, DWORD *flags,
5034     LPWSTR buf, UINT size)
5035 {
5036 #define SHFORMATDT_UNSUPPORTED_FLAGS (FDTF_RELATIVE | FDTF_LTRDATE | FDTF_RTLDATE | FDTF_NOAUTOREADINGORDER)
5037     DWORD fmt_flags = flags ? *flags : FDTF_DEFAULT;
5038     SYSTEMTIME st;
5039     FILETIME ft;
5040     INT ret = 0;
5041
5042     TRACE("%p %p %p %u\n", fileTime, flags, buf, size);
5043
5044     if (!buf || !size)
5045         return 0;
5046
5047     if (fmt_flags & SHFORMATDT_UNSUPPORTED_FLAGS)
5048         FIXME("ignoring some flags - 0x%08x\n", fmt_flags & SHFORMATDT_UNSUPPORTED_FLAGS);
5049
5050     FileTimeToLocalFileTime(fileTime, &ft);
5051     FileTimeToSystemTime(&ft, &st);
5052
5053     /* first of all date */
5054     if (fmt_flags & (FDTF_LONGDATE | FDTF_SHORTDATE))
5055     {
5056         static const WCHAR sep1[] = {',',' ',0};
5057         static const WCHAR sep2[] = {' ',0};
5058
5059         DWORD date = fmt_flags & FDTF_LONGDATE ? DATE_LONGDATE : DATE_SHORTDATE;
5060         ret = GetDateFormatW(LOCALE_USER_DEFAULT, date, &st, NULL, buf, size);
5061         if (ret >= size) return ret;
5062
5063         /* add separator */
5064         if (ret < size && (fmt_flags & (FDTF_LONGTIME | FDTF_SHORTTIME)))
5065         {
5066             if ((fmt_flags & FDTF_LONGDATE) && (ret < size + 2))
5067             {
5068                 if (ret < size + 2)
5069                 {
5070                    lstrcatW(&buf[ret-1], sep1);
5071                    ret += 2;
5072                 }
5073             }
5074             else
5075             {
5076                 lstrcatW(&buf[ret-1], sep2);
5077                 ret++;
5078             }
5079         }
5080     }
5081     /* time part */
5082     if (fmt_flags & (FDTF_LONGTIME | FDTF_SHORTTIME))
5083     {
5084         DWORD time = fmt_flags & FDTF_LONGTIME ? 0 : TIME_NOSECONDS;
5085
5086         if (ret) ret--;
5087         ret += GetTimeFormatW(LOCALE_USER_DEFAULT, time, &st, NULL, &buf[ret], size - ret);
5088     }
5089
5090     return ret;
5091
5092 #undef SHFORMATDT_UNSUPPORTED_FLAGS
5093 }
5094
5095 /***********************************************************************
5096  *             SHFormatDateTimeA [SHLWAPI.353]
5097  *
5098  * See SHFormatDateTimeW.
5099  *
5100  */
5101 INT WINAPI SHFormatDateTimeA(const FILETIME UNALIGNED *fileTime, DWORD *flags,
5102     LPSTR buf, UINT size)
5103 {
5104     WCHAR *bufW;
5105     INT retval;
5106
5107     if (!buf || !size)
5108         return 0;
5109
5110     bufW = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * size);
5111     retval = SHFormatDateTimeW(fileTime, flags, bufW, size);
5112
5113     if (retval != 0)
5114         WideCharToMultiByte(CP_ACP, 0, bufW, -1, buf, size, NULL, NULL);
5115
5116     HeapFree(GetProcessHeap(), 0, bufW);
5117     return retval;
5118 }
5119
5120 /***********************************************************************
5121  *             ZoneCheckUrlExW [SHLWAPI.231]
5122  *
5123  * Checks the details of the security zone for the supplied site. (?)
5124  *
5125  * PARAMS
5126  *
5127  *  szURL   [I] Pointer to the URL to check
5128  *
5129  *  Other parameters currently unknown.
5130  *
5131  * RETURNS
5132  *  unknown
5133  */
5134
5135 INT WINAPI ZoneCheckUrlExW(LPWSTR szURL, PVOID pUnknown, DWORD dwUnknown2,
5136     DWORD dwUnknown3, DWORD dwUnknown4, DWORD dwUnknown5, DWORD dwUnknown6,
5137     DWORD dwUnknown7)
5138 {
5139     FIXME("(%s,%p,%x,%x,%x,%x,%x,%x) STUB\n", debugstr_w(szURL), pUnknown, dwUnknown2,
5140         dwUnknown3, dwUnknown4, dwUnknown5, dwUnknown6, dwUnknown7);
5141
5142     return 0;
5143 }
5144
5145 /***********************************************************************
5146  *             SHVerbExistsNA [SHLWAPI.196]
5147  *
5148  *
5149  * PARAMS
5150  *
5151  *  verb [I] a string, often appears to be an extension.
5152  *
5153  *  Other parameters currently unknown.
5154  *
5155  * RETURNS
5156  *  unknown
5157  */
5158 INT WINAPI SHVerbExistsNA(LPSTR verb, PVOID pUnknown, PVOID pUnknown2, DWORD dwUnknown3)
5159 {
5160     FIXME("(%s, %p, %p, %i) STUB\n",verb, pUnknown, pUnknown2, dwUnknown3);
5161     return 0;
5162 }
5163
5164 /*************************************************************************
5165  *      @       [SHLWAPI.538]
5166  *
5167  *  Undocumented:  Implementation guessed at via Name and behavior
5168  *
5169  * PARAMS
5170  *  lpUnknown [I] Object to get an IServiceProvider interface from
5171  *  riid      [I] Function requested for QueryService call
5172  *  lppOut    [O] Destination for the service interface pointer
5173  *
5174  * RETURNS
5175  *  Success: S_OK. lppOut contains an object providing the requested service
5176  *  Failure: An HRESULT error code
5177  *
5178  * NOTES
5179  *  lpUnknown is expected to support the IServiceProvider interface.
5180  */
5181 HRESULT WINAPI IUnknown_QueryServiceForWebBrowserApp(IUnknown* lpUnknown,
5182         REFGUID riid, LPVOID *lppOut)
5183 {
5184     FIXME("%p %s %p semi-STUB\n", lpUnknown, debugstr_guid(riid), lppOut);
5185     return IUnknown_QueryService(lpUnknown,&IID_IWebBrowserApp,riid,lppOut);
5186 }
5187
5188 /**************************************************************************
5189  *  SHPropertyBag_ReadLONG (SHLWAPI.496)
5190  *
5191  * This function asks a property bag to read a named property as a LONG.
5192  *
5193  * PARAMS
5194  *  ppb: a IPropertyBag interface
5195  *  pszPropName:  Unicode string that names the property
5196  *  pValue: address to receive the property value as a 32-bit signed integer
5197  *
5198  * RETURNS
5199  *  0 for Success
5200  */
5201 BOOL WINAPI SHPropertyBag_ReadLONG(IPropertyBag *ppb, LPCWSTR pszPropName, LPLONG pValue)
5202 {
5203     VARIANT var;
5204     HRESULT hr;
5205     TRACE("%p %s %p\n", ppb,debugstr_w(pszPropName),pValue);
5206     if (!pszPropName || !ppb || !pValue)
5207         return E_INVALIDARG;
5208     V_VT(&var) = VT_I4;
5209     hr = IPropertyBag_Read(ppb, pszPropName, &var, NULL);
5210     if (SUCCEEDED(hr))
5211     {
5212         if (V_VT(&var) == VT_I4)
5213             *pValue = V_I4(&var);
5214         else
5215             hr = DISP_E_BADVARTYPE;
5216     }
5217     return hr;
5218 }
5219
5220 /* return flags for SHGetObjectCompatFlags, names derived from registry value names */
5221 #define OBJCOMPAT_OTNEEDSSFCACHE           0x00000001
5222 #define OBJCOMPAT_NO_WEBVIEW               0x00000002
5223 #define OBJCOMPAT_UNBINDABLE               0x00000004
5224 #define OBJCOMPAT_PINDLL                   0x00000008
5225 #define OBJCOMPAT_NEEDSFILESYSANCESTOR     0x00000010
5226 #define OBJCOMPAT_NOTAFILESYSTEM           0x00000020
5227 #define OBJCOMPAT_CTXMENU_NOVERBS          0x00000040
5228 #define OBJCOMPAT_CTXMENU_LIMITEDQI        0x00000080
5229 #define OBJCOMPAT_COCREATESHELLFOLDERONLY  0x00000100
5230 #define OBJCOMPAT_NEEDSSTORAGEANCESTOR     0x00000200
5231 #define OBJCOMPAT_NOLEGACYWEBVIEW          0x00000400
5232 #define OBJCOMPAT_CTXMENU_XPQCMFLAGS       0x00001000
5233 #define OBJCOMPAT_NOIPROPERTYSTORE         0x00002000
5234
5235 /* a search table for compatibility flags */
5236 struct objcompat_entry {
5237     const WCHAR name[30];
5238     DWORD value;
5239 };
5240
5241 /* expected to be sorted by name */
5242 static const struct objcompat_entry objcompat_table[] = {
5243     { {'C','O','C','R','E','A','T','E','S','H','E','L','L','F','O','L','D','E','R','O','N','L','Y',0},
5244       OBJCOMPAT_COCREATESHELLFOLDERONLY },
5245     { {'C','T','X','M','E','N','U','_','L','I','M','I','T','E','D','Q','I',0},
5246       OBJCOMPAT_CTXMENU_LIMITEDQI },
5247     { {'C','T','X','M','E','N','U','_','N','O','V','E','R','B','S',0},
5248       OBJCOMPAT_CTXMENU_LIMITEDQI },
5249     { {'C','T','X','M','E','N','U','_','X','P','Q','C','M','F','L','A','G','S',0},
5250       OBJCOMPAT_CTXMENU_XPQCMFLAGS },
5251     { {'N','E','E','D','S','F','I','L','E','S','Y','S','A','N','C','E','S','T','O','R',0},
5252       OBJCOMPAT_NEEDSFILESYSANCESTOR },
5253     { {'N','E','E','D','S','S','T','O','R','A','G','E','A','N','C','E','S','T','O','R',0},
5254       OBJCOMPAT_NEEDSSTORAGEANCESTOR },
5255     { {'N','O','I','P','R','O','P','E','R','T','Y','S','T','O','R','E',0},
5256       OBJCOMPAT_NOIPROPERTYSTORE },
5257     { {'N','O','L','E','G','A','C','Y','W','E','B','V','I','E','W',0},
5258       OBJCOMPAT_NOLEGACYWEBVIEW },
5259     { {'N','O','T','A','F','I','L','E','S','Y','S','T','E','M',0},
5260       OBJCOMPAT_NOTAFILESYSTEM },
5261     { {'N','O','_','W','E','B','V','I','E','W',0},
5262       OBJCOMPAT_NO_WEBVIEW },
5263     { {'O','T','N','E','E','D','S','S','F','C','A','C','H','E',0},
5264       OBJCOMPAT_OTNEEDSSFCACHE },
5265     { {'P','I','N','D','L','L',0},
5266       OBJCOMPAT_PINDLL },
5267     { {'U','N','B','I','N','D','A','B','L','E',0},
5268       OBJCOMPAT_UNBINDABLE }
5269 };
5270
5271 /**************************************************************************
5272  *  SHGetObjectCompatFlags (SHLWAPI.476)
5273  *
5274  * Function returns an integer representation of compatibility flags stored
5275  * in registry for CLSID under ShellCompatibility subkey.
5276  *
5277  * PARAMS
5278  *  pUnk:  pointer to object IUnknown interface, idetifies CLSID
5279  *  clsid: pointer to CLSID to retrieve data for
5280  *
5281  * RETURNS
5282  *  0 on failure, flags set on success
5283  */
5284 DWORD WINAPI SHGetObjectCompatFlags(IUnknown *pUnk, const CLSID *clsid)
5285 {
5286     static const WCHAR compatpathW[] =
5287         {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o','s','o','f','t','\\',
5288          'W','i','n','d','o','w','s','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\',
5289          'S','h','e','l','l','C','o','m','p','a','t','i','b','i','l','i','t','y','\\',
5290          'O','b','j','e','c','t','s','\\','%','s',0};
5291     WCHAR strW[sizeof(compatpathW)/sizeof(WCHAR) + 38 /* { CLSID } */];
5292     DWORD ret, length = sizeof(strW)/sizeof(WCHAR);
5293     OLECHAR *clsid_str;
5294     HKEY key;
5295     INT i;
5296
5297     TRACE("%p %s\n", pUnk, debugstr_guid(clsid));
5298
5299     if (!pUnk && !clsid) return 0;
5300
5301     if (pUnk && !clsid)
5302     {
5303         FIXME("iface not handled\n");
5304         return 0;
5305     }
5306
5307     StringFromCLSID(clsid, &clsid_str);
5308     sprintfW(strW, compatpathW, clsid_str);
5309     CoTaskMemFree(clsid_str);
5310
5311     ret = RegOpenKeyW(HKEY_LOCAL_MACHINE, strW, &key);
5312     if (ret != ERROR_SUCCESS) return 0;
5313
5314     /* now collect flag values */
5315     ret = 0;
5316     for (i = 0; RegEnumValueW(key, i, strW, &length, NULL, NULL, NULL, NULL) == ERROR_SUCCESS; i++)
5317     {
5318         INT left, right, res, x;
5319
5320         /* search in table */
5321         left  = 0;
5322         right = sizeof(objcompat_table) / sizeof(struct objcompat_entry) - 1;
5323
5324         while (right >= left) {
5325             x = (left + right) / 2;
5326             res = strcmpW(strW, objcompat_table[x].name);
5327             if (res == 0)
5328             {
5329                 ret |= objcompat_table[x].value;
5330                 break;
5331             }
5332             else if (res < 0)
5333                 right = x - 1;
5334             else
5335                 left = x + 1;
5336         }
5337
5338         length = sizeof(strW)/sizeof(WCHAR);
5339     }
5340
5341     return ret;
5342 }