maintainers: Update winemaker section.
[wine.git] / dlls / shlwapi / ordinal.c
blob3c8af5ccfcf8798c82a2895311e29bad30c51685
1 /*
2 * SHLWAPI ordinal functions
4 * Copyright 1997 Marcus Meissner
5 * 1998 Jürgen Schmied
6 * 2001-2003 Jon Griffiths
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.
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.
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
23 #include "config.h"
24 #include "wine/port.h"
26 #include <stdarg.h>
27 #include <stdio.h>
28 #include <string.h>
30 #define COBJMACROS
32 #include "windef.h"
33 #include "winbase.h"
34 #include "winnls.h"
35 #include "winreg.h"
36 #include "wingdi.h"
37 #include "winuser.h"
38 #include "winver.h"
39 #include "winnetwk.h"
40 #include "mmsystem.h"
41 #include "objbase.h"
42 #include "exdisp.h"
43 #include "shdeprecated.h"
44 #include "shlobj.h"
45 #include "shlwapi.h"
46 #include "shellapi.h"
47 #include "commdlg.h"
48 #include "mlang.h"
49 #include "mshtmhst.h"
50 #include "wine/unicode.h"
51 #include "wine/debug.h"
54 WINE_DEFAULT_DEBUG_CHANNEL(shell);
56 /* DLL handles for late bound calls */
57 extern HINSTANCE shlwapi_hInstance;
58 extern DWORD SHLWAPI_ThreadRef_index;
60 HRESULT WINAPI IUnknown_QueryService(IUnknown*,REFGUID,REFIID,LPVOID*);
61 HRESULT WINAPI SHInvokeCommand(HWND,IShellFolder*,LPCITEMIDLIST,DWORD);
62 BOOL WINAPI SHAboutInfoW(LPWSTR,DWORD);
65 NOTES: Most functions exported by ordinal seem to be superfluous.
66 The reason for these functions to be there is to provide a wrapper
67 for unicode functions to provide these functions on systems without
68 unicode functions eg. win95/win98. Since we have such functions we just
69 call these. If running Wine with native DLLs, some late bound calls may
70 fail. However, it is better to implement the functions in the forward DLL
71 and recommend the builtin rather than reimplementing the calls here!
74 /*************************************************************************
75 * @ [SHLWAPI.11]
77 * Copy a sharable memory handle from one process to another.
79 * PARAMS
80 * hShared [I] Shared memory handle to duplicate
81 * dwSrcProcId [I] ID of the process owning hShared
82 * dwDstProcId [I] ID of the process wanting the duplicated handle
83 * dwAccess [I] Desired DuplicateHandle() access
84 * dwOptions [I] Desired DuplicateHandle() options
86 * RETURNS
87 * Success: A handle suitable for use by the dwDstProcId process.
88 * Failure: A NULL handle.
91 HANDLE WINAPI SHMapHandle(HANDLE hShared, DWORD dwSrcProcId, DWORD dwDstProcId,
92 DWORD dwAccess, DWORD dwOptions)
94 HANDLE hDst, hSrc;
95 DWORD dwMyProcId = GetCurrentProcessId();
96 HANDLE hRet = NULL;
98 TRACE("(%p,%d,%d,%08x,%08x)\n", hShared, dwDstProcId, dwSrcProcId,
99 dwAccess, dwOptions);
101 /* Get dest process handle */
102 if (dwDstProcId == dwMyProcId)
103 hDst = GetCurrentProcess();
104 else
105 hDst = OpenProcess(PROCESS_DUP_HANDLE, 0, dwDstProcId);
107 if (hDst)
109 /* Get src process handle */
110 if (dwSrcProcId == dwMyProcId)
111 hSrc = GetCurrentProcess();
112 else
113 hSrc = OpenProcess(PROCESS_DUP_HANDLE, 0, dwSrcProcId);
115 if (hSrc)
117 /* Make handle available to dest process */
118 if (!DuplicateHandle(hSrc, hShared, hDst, &hRet,
119 dwAccess, 0, dwOptions | DUPLICATE_SAME_ACCESS))
120 hRet = NULL;
122 if (dwSrcProcId != dwMyProcId)
123 CloseHandle(hSrc);
126 if (dwDstProcId != dwMyProcId)
127 CloseHandle(hDst);
130 TRACE("Returning handle %p\n", hRet);
131 return hRet;
134 /*************************************************************************
135 * @ [SHLWAPI.7]
137 * Create a block of sharable memory and initialise it with data.
139 * PARAMS
140 * lpvData [I] Pointer to data to write
141 * dwSize [I] Size of data
142 * dwProcId [I] ID of process owning data
144 * RETURNS
145 * Success: A shared memory handle
146 * Failure: NULL
148 * NOTES
149 * Ordinals 7-11 provide a set of calls to create shared memory between a
150 * group of processes. The shared memory is treated opaquely in that its size
151 * is not exposed to clients who map it. This is accomplished by storing
152 * the size of the map as the first DWORD of mapped data, and then offsetting
153 * the view pointer returned by this size.
156 HANDLE WINAPI SHAllocShared(LPCVOID lpvData, DWORD dwSize, DWORD dwProcId)
158 HANDLE hMap;
159 LPVOID pMapped;
160 HANDLE hRet = NULL;
162 TRACE("(%p,%d,%d)\n", lpvData, dwSize, dwProcId);
164 /* Create file mapping of the correct length */
165 hMap = CreateFileMappingA(INVALID_HANDLE_VALUE, NULL, FILE_MAP_READ, 0,
166 dwSize + sizeof(dwSize), NULL);
167 if (!hMap)
168 return hRet;
170 /* Get a view in our process address space */
171 pMapped = MapViewOfFile(hMap, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
173 if (pMapped)
175 /* Write size of data, followed by the data, to the view */
176 *((DWORD*)pMapped) = dwSize;
177 if (lpvData)
178 memcpy((char *) pMapped + sizeof(dwSize), lpvData, dwSize);
180 /* Release view. All further views mapped will be opaque */
181 UnmapViewOfFile(pMapped);
182 hRet = SHMapHandle(hMap, GetCurrentProcessId(), dwProcId,
183 FILE_MAP_ALL_ACCESS, DUPLICATE_SAME_ACCESS);
186 CloseHandle(hMap);
187 return hRet;
190 /*************************************************************************
191 * @ [SHLWAPI.8]
193 * Get a pointer to a block of shared memory from a shared memory handle.
195 * PARAMS
196 * hShared [I] Shared memory handle
197 * dwProcId [I] ID of process owning hShared
199 * RETURNS
200 * Success: A pointer to the shared memory
201 * Failure: NULL
204 PVOID WINAPI SHLockShared(HANDLE hShared, DWORD dwProcId)
206 HANDLE hDup;
207 LPVOID pMapped;
209 TRACE("(%p %d)\n", hShared, dwProcId);
211 /* Get handle to shared memory for current process */
212 hDup = SHMapHandle(hShared, dwProcId, GetCurrentProcessId(), FILE_MAP_ALL_ACCESS, 0);
214 /* Get View */
215 pMapped = MapViewOfFile(hDup, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
216 CloseHandle(hDup);
218 if (pMapped)
219 return (char *) pMapped + sizeof(DWORD); /* Hide size */
220 return NULL;
223 /*************************************************************************
224 * @ [SHLWAPI.9]
226 * Release a pointer to a block of shared memory.
228 * PARAMS
229 * lpView [I] Shared memory pointer
231 * RETURNS
232 * Success: TRUE
233 * Failure: FALSE
236 BOOL WINAPI SHUnlockShared(LPVOID lpView)
238 TRACE("(%p)\n", lpView);
239 return UnmapViewOfFile((char *) lpView - sizeof(DWORD)); /* Include size */
242 /*************************************************************************
243 * @ [SHLWAPI.10]
245 * Destroy a block of sharable memory.
247 * PARAMS
248 * hShared [I] Shared memory handle
249 * dwProcId [I] ID of process owning hShared
251 * RETURNS
252 * Success: TRUE
253 * Failure: FALSE
256 BOOL WINAPI SHFreeShared(HANDLE hShared, DWORD dwProcId)
258 HANDLE hClose;
260 TRACE("(%p %d)\n", hShared, dwProcId);
262 /* Get a copy of the handle for our process, closing the source handle */
263 hClose = SHMapHandle(hShared, dwProcId, GetCurrentProcessId(),
264 FILE_MAP_ALL_ACCESS,DUPLICATE_CLOSE_SOURCE);
265 /* Close local copy */
266 return CloseHandle(hClose);
269 /*************************************************************************
270 * @ [SHLWAPI.13]
272 * Create and register a clipboard enumerator for a web browser.
274 * PARAMS
275 * lpBC [I] Binding context
276 * lpUnknown [I] An object exposing the IWebBrowserApp interface
278 * RETURNS
279 * Success: S_OK.
280 * Failure: An HRESULT error code.
282 * NOTES
283 * The enumerator is stored as a property of the web browser. If it does not
284 * yet exist, it is created and set before being registered.
286 HRESULT WINAPI RegisterDefaultAcceptHeaders(LPBC lpBC, IUnknown *lpUnknown)
288 static const WCHAR szProperty[] = { '{','D','0','F','C','A','4','2','0',
289 '-','D','3','F','5','-','1','1','C','F', '-','B','2','1','1','-','0',
290 '0','A','A','0','0','4','A','E','8','3','7','}','\0' };
291 BSTR property;
292 IEnumFORMATETC* pIEnumFormatEtc = NULL;
293 VARIANTARG var;
294 HRESULT hr;
295 IWebBrowserApp* pBrowser;
297 TRACE("(%p, %p)\n", lpBC, lpUnknown);
299 hr = IUnknown_QueryService(lpUnknown, &IID_IWebBrowserApp, &IID_IWebBrowserApp, (void**)&pBrowser);
300 if (FAILED(hr))
301 return hr;
303 V_VT(&var) = VT_EMPTY;
305 /* The property we get is the browsers clipboard enumerator */
306 property = SysAllocString(szProperty);
307 hr = IWebBrowserApp_GetProperty(pBrowser, property, &var);
308 SysFreeString(property);
309 if (FAILED(hr)) goto exit;
311 if (V_VT(&var) == VT_EMPTY)
313 /* Iterate through accepted documents and RegisterClipBoardFormatA() them */
314 char szKeyBuff[128], szValueBuff[128];
315 DWORD dwKeySize, dwValueSize, dwRet = 0, dwCount = 0, dwNumValues, dwType;
316 FORMATETC* formatList, *format;
317 HKEY hDocs;
319 TRACE("Registering formats and creating IEnumFORMATETC instance\n");
321 if (!RegOpenKeyA(HKEY_LOCAL_MACHINE, "Software\\Microsoft\\Windows\\Current"
322 "Version\\Internet Settings\\Accepted Documents", &hDocs))
324 hr = E_FAIL;
325 goto exit;
328 /* Get count of values in key */
329 while (!dwRet)
331 dwKeySize = sizeof(szKeyBuff);
332 dwRet = RegEnumValueA(hDocs,dwCount,szKeyBuff,&dwKeySize,0,&dwType,0,0);
333 dwCount++;
336 dwNumValues = dwCount;
338 /* Note: dwCount = number of items + 1; The extra item is the end node */
339 format = formatList = HeapAlloc(GetProcessHeap(), 0, dwCount * sizeof(FORMATETC));
340 if (!formatList)
342 RegCloseKey(hDocs);
343 hr = E_OUTOFMEMORY;
344 goto exit;
347 if (dwNumValues > 1)
349 dwRet = 0;
350 dwCount = 0;
352 dwNumValues--;
354 /* Register clipboard formats for the values and populate format list */
355 while(!dwRet && dwCount < dwNumValues)
357 dwKeySize = sizeof(szKeyBuff);
358 dwValueSize = sizeof(szValueBuff);
359 dwRet = RegEnumValueA(hDocs, dwCount, szKeyBuff, &dwKeySize, 0, &dwType,
360 (PBYTE)szValueBuff, &dwValueSize);
361 if (!dwRet)
363 HeapFree(GetProcessHeap(), 0, formatList);
364 RegCloseKey(hDocs);
365 hr = E_FAIL;
366 goto exit;
369 format->cfFormat = RegisterClipboardFormatA(szValueBuff);
370 format->ptd = NULL;
371 format->dwAspect = 1;
372 format->lindex = 4;
373 format->tymed = -1;
375 format++;
376 dwCount++;
380 RegCloseKey(hDocs);
382 /* Terminate the (maybe empty) list, last entry has a cfFormat of 0 */
383 format->cfFormat = 0;
384 format->ptd = NULL;
385 format->dwAspect = 1;
386 format->lindex = 4;
387 format->tymed = -1;
389 /* Create a clipboard enumerator */
390 hr = CreateFormatEnumerator(dwNumValues, formatList, &pIEnumFormatEtc);
391 HeapFree(GetProcessHeap(), 0, formatList);
392 if (FAILED(hr)) goto exit;
394 /* Set our enumerator as the browsers property */
395 V_VT(&var) = VT_UNKNOWN;
396 V_UNKNOWN(&var) = (IUnknown*)pIEnumFormatEtc;
398 property = SysAllocString(szProperty);
399 hr = IWebBrowserApp_PutProperty(pBrowser, property, var);
400 SysFreeString(property);
401 if (FAILED(hr))
403 IEnumFORMATETC_Release(pIEnumFormatEtc);
404 goto exit;
408 if (V_VT(&var) == VT_UNKNOWN)
410 /* Our variant is holding the clipboard enumerator */
411 IUnknown* pIUnknown = V_UNKNOWN(&var);
412 IEnumFORMATETC* pClone = NULL;
414 TRACE("Retrieved IEnumFORMATETC property\n");
416 /* Get an IEnumFormatEtc interface from the variants value */
417 pIEnumFormatEtc = NULL;
418 hr = IUnknown_QueryInterface(pIUnknown, &IID_IEnumFORMATETC, (void**)&pIEnumFormatEtc);
419 if (hr == S_OK && pIEnumFormatEtc)
421 /* Clone and register the enumerator */
422 hr = IEnumFORMATETC_Clone(pIEnumFormatEtc, &pClone);
423 if (hr == S_OK && pClone)
425 RegisterFormatEnumerator(lpBC, pClone, 0);
427 IEnumFORMATETC_Release(pClone);
430 IUnknown_Release(pIUnknown);
432 IUnknown_Release(V_UNKNOWN(&var));
435 exit:
436 IWebBrowserApp_Release(pBrowser);
437 return hr;
440 /*************************************************************************
441 * @ [SHLWAPI.15]
443 * Get Explorers "AcceptLanguage" setting.
445 * PARAMS
446 * langbuf [O] Destination for language string
447 * buflen [I] Length of langbuf in characters
448 * [0] Success: used length of langbuf
450 * RETURNS
451 * Success: S_OK. langbuf is set to the language string found.
452 * Failure: E_FAIL, If any arguments are invalid, error occurred, or Explorer
453 * does not contain the setting.
454 * E_NOT_SUFFICIENT_BUFFER, If the buffer is not big enough
456 HRESULT WINAPI GetAcceptLanguagesW( LPWSTR langbuf, LPDWORD buflen)
458 static const WCHAR szkeyW[] = {
459 'S','o','f','t','w','a','r','e','\\',
460 'M','i','c','r','o','s','o','f','t','\\',
461 'I','n','t','e','r','n','e','t',' ','E','x','p','l','o','r','e','r','\\',
462 'I','n','t','e','r','n','a','t','i','o','n','a','l',0};
463 static const WCHAR valueW[] = {
464 'A','c','c','e','p','t','L','a','n','g','u','a','g','e',0};
465 DWORD mystrlen, mytype;
466 DWORD len;
467 HKEY mykey;
468 LCID mylcid;
469 WCHAR *mystr;
470 LONG lres;
472 TRACE("(%p, %p) *%p: %d\n", langbuf, buflen, buflen, buflen ? *buflen : -1);
474 if(!langbuf || !buflen || !*buflen)
475 return E_FAIL;
477 mystrlen = (*buflen > 20) ? *buflen : 20 ;
478 len = mystrlen * sizeof(WCHAR);
479 mystr = HeapAlloc(GetProcessHeap(), 0, len);
480 mystr[0] = 0;
481 RegOpenKeyW(HKEY_CURRENT_USER, szkeyW, &mykey);
482 lres = RegQueryValueExW(mykey, valueW, 0, &mytype, (PBYTE)mystr, &len);
483 RegCloseKey(mykey);
484 len = lstrlenW(mystr);
486 if (!lres && (*buflen > len)) {
487 lstrcpyW(langbuf, mystr);
488 *buflen = len;
489 HeapFree(GetProcessHeap(), 0, mystr);
490 return S_OK;
493 /* Did not find a value in the registry or the user buffer is too small */
494 mylcid = GetUserDefaultLCID();
495 LcidToRfc1766W(mylcid, mystr, mystrlen);
496 len = lstrlenW(mystr);
498 memcpy( langbuf, mystr, min(*buflen, len+1)*sizeof(WCHAR) );
499 HeapFree(GetProcessHeap(), 0, mystr);
501 if (*buflen > len) {
502 *buflen = len;
503 return S_OK;
506 *buflen = 0;
507 return E_NOT_SUFFICIENT_BUFFER;
510 /*************************************************************************
511 * @ [SHLWAPI.14]
513 * Ascii version of GetAcceptLanguagesW.
515 HRESULT WINAPI GetAcceptLanguagesA( LPSTR langbuf, LPDWORD buflen)
517 WCHAR *langbufW;
518 DWORD buflenW, convlen;
519 HRESULT retval;
521 TRACE("(%p, %p) *%p: %d\n", langbuf, buflen, buflen, buflen ? *buflen : -1);
523 if(!langbuf || !buflen || !*buflen) return E_FAIL;
525 buflenW = *buflen;
526 langbufW = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * buflenW);
527 retval = GetAcceptLanguagesW(langbufW, &buflenW);
529 if (retval == S_OK)
531 convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, -1, langbuf, *buflen, NULL, NULL);
532 convlen--; /* do not count the terminating 0 */
534 else /* copy partial string anyway */
536 convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, *buflen, langbuf, *buflen, NULL, NULL);
537 if (convlen < *buflen)
539 langbuf[convlen] = 0;
540 convlen--; /* do not count the terminating 0 */
542 else
544 convlen = *buflen;
547 *buflen = buflenW ? convlen : 0;
549 HeapFree(GetProcessHeap(), 0, langbufW);
550 return retval;
553 /*************************************************************************
554 * @ [SHLWAPI.23]
556 * Convert a GUID to a string.
558 * PARAMS
559 * guid [I] GUID to convert
560 * lpszDest [O] Destination for string
561 * cchMax [I] Length of output buffer
563 * RETURNS
564 * The length of the string created.
566 INT WINAPI SHStringFromGUIDA(REFGUID guid, LPSTR lpszDest, INT cchMax)
568 char xguid[40];
569 INT iLen;
571 TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
573 sprintf(xguid, "{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}",
574 guid->Data1, guid->Data2, guid->Data3,
575 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
576 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
578 iLen = strlen(xguid) + 1;
580 if (iLen > cchMax)
581 return 0;
582 memcpy(lpszDest, xguid, iLen);
583 return iLen;
586 /*************************************************************************
587 * @ [SHLWAPI.24]
589 * Convert a GUID to a string.
591 * PARAMS
592 * guid [I] GUID to convert
593 * str [O] Destination for string
594 * cmax [I] Length of output buffer
596 * RETURNS
597 * The length of the string created.
599 INT WINAPI SHStringFromGUIDW(REFGUID guid, LPWSTR lpszDest, INT cchMax)
601 WCHAR xguid[40];
602 INT iLen;
603 static const WCHAR wszFormat[] = {'{','%','0','8','l','X','-','%','0','4','X','-','%','0','4','X','-',
604 '%','0','2','X','%','0','2','X','-','%','0','2','X','%','0','2','X','%','0','2','X','%','0','2',
605 'X','%','0','2','X','%','0','2','X','}',0};
607 TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
609 sprintfW(xguid, wszFormat, guid->Data1, guid->Data2, guid->Data3,
610 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
611 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
613 iLen = strlenW(xguid) + 1;
615 if (iLen > cchMax)
616 return 0;
617 memcpy(lpszDest, xguid, iLen*sizeof(WCHAR));
618 return iLen;
621 /*************************************************************************
622 * @ [SHLWAPI.30]
624 * Determine if a Unicode character is a blank.
626 * PARAMS
627 * wc [I] Character to check.
629 * RETURNS
630 * TRUE, if wc is a blank,
631 * FALSE otherwise.
634 BOOL WINAPI IsCharBlankW(WCHAR wc)
636 WORD CharType;
638 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_BLANK);
641 /*************************************************************************
642 * @ [SHLWAPI.31]
644 * Determine if a Unicode character is punctuation.
646 * PARAMS
647 * wc [I] Character to check.
649 * RETURNS
650 * TRUE, if wc is punctuation,
651 * FALSE otherwise.
653 BOOL WINAPI IsCharPunctW(WCHAR wc)
655 WORD CharType;
657 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_PUNCT);
660 /*************************************************************************
661 * @ [SHLWAPI.32]
663 * Determine if a Unicode character is a control character.
665 * PARAMS
666 * wc [I] Character to check.
668 * RETURNS
669 * TRUE, if wc is a control character,
670 * FALSE otherwise.
672 BOOL WINAPI IsCharCntrlW(WCHAR wc)
674 WORD CharType;
676 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_CNTRL);
679 /*************************************************************************
680 * @ [SHLWAPI.33]
682 * Determine if a Unicode character is a digit.
684 * PARAMS
685 * wc [I] Character to check.
687 * RETURNS
688 * TRUE, if wc is a digit,
689 * FALSE otherwise.
691 BOOL WINAPI IsCharDigitW(WCHAR wc)
693 WORD CharType;
695 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_DIGIT);
698 /*************************************************************************
699 * @ [SHLWAPI.34]
701 * Determine if a Unicode character is a hex digit.
703 * PARAMS
704 * wc [I] Character to check.
706 * RETURNS
707 * TRUE, if wc is a hex digit,
708 * FALSE otherwise.
710 BOOL WINAPI IsCharXDigitW(WCHAR wc)
712 WORD CharType;
714 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_XDIGIT);
717 /*************************************************************************
718 * @ [SHLWAPI.35]
721 BOOL WINAPI GetStringType3ExW(LPWSTR src, INT count, LPWORD type)
723 return GetStringTypeW(CT_CTYPE3, src, count, type);
726 /*************************************************************************
727 * @ [SHLWAPI.151]
729 * Compare two Ascii strings up to a given length.
731 * PARAMS
732 * lpszSrc [I] Source string
733 * lpszCmp [I] String to compare to lpszSrc
734 * len [I] Maximum length
736 * RETURNS
737 * A number greater than, less than or equal to 0 depending on whether
738 * lpszSrc is greater than, less than or equal to lpszCmp.
740 DWORD WINAPI StrCmpNCA(LPCSTR lpszSrc, LPCSTR lpszCmp, INT len)
742 return StrCmpNA(lpszSrc, lpszCmp, len);
745 /*************************************************************************
746 * @ [SHLWAPI.152]
748 * Unicode version of StrCmpNCA.
750 DWORD WINAPI StrCmpNCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, INT len)
752 return StrCmpNW(lpszSrc, lpszCmp, len);
755 /*************************************************************************
756 * @ [SHLWAPI.153]
758 * Compare two Ascii strings up to a given length, ignoring case.
760 * PARAMS
761 * lpszSrc [I] Source string
762 * lpszCmp [I] String to compare to lpszSrc
763 * len [I] Maximum length
765 * RETURNS
766 * A number greater than, less than or equal to 0 depending on whether
767 * lpszSrc is greater than, less than or equal to lpszCmp.
769 DWORD WINAPI StrCmpNICA(LPCSTR lpszSrc, LPCSTR lpszCmp, DWORD len)
771 return StrCmpNIA(lpszSrc, lpszCmp, len);
774 /*************************************************************************
775 * @ [SHLWAPI.154]
777 * Unicode version of StrCmpNICA.
779 DWORD WINAPI StrCmpNICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, DWORD len)
781 return StrCmpNIW(lpszSrc, lpszCmp, len);
784 /*************************************************************************
785 * @ [SHLWAPI.155]
787 * Compare two Ascii strings.
789 * PARAMS
790 * lpszSrc [I] Source string
791 * lpszCmp [I] String to compare to lpszSrc
793 * RETURNS
794 * A number greater than, less than or equal to 0 depending on whether
795 * lpszSrc is greater than, less than or equal to lpszCmp.
797 DWORD WINAPI StrCmpCA(LPCSTR lpszSrc, LPCSTR lpszCmp)
799 return lstrcmpA(lpszSrc, lpszCmp);
802 /*************************************************************************
803 * @ [SHLWAPI.156]
805 * Unicode version of StrCmpCA.
807 DWORD WINAPI StrCmpCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
809 return lstrcmpW(lpszSrc, lpszCmp);
812 /*************************************************************************
813 * @ [SHLWAPI.157]
815 * Compare two Ascii strings, ignoring case.
817 * PARAMS
818 * lpszSrc [I] Source string
819 * lpszCmp [I] String to compare to lpszSrc
821 * RETURNS
822 * A number greater than, less than or equal to 0 depending on whether
823 * lpszSrc is greater than, less than or equal to lpszCmp.
825 DWORD WINAPI StrCmpICA(LPCSTR lpszSrc, LPCSTR lpszCmp)
827 return lstrcmpiA(lpszSrc, lpszCmp);
830 /*************************************************************************
831 * @ [SHLWAPI.158]
833 * Unicode version of StrCmpICA.
835 DWORD WINAPI StrCmpICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
837 return lstrcmpiW(lpszSrc, lpszCmp);
840 /*************************************************************************
841 * @ [SHLWAPI.160]
843 * Get an identification string for the OS and explorer.
845 * PARAMS
846 * lpszDest [O] Destination for Id string
847 * dwDestLen [I] Length of lpszDest
849 * RETURNS
850 * TRUE, If the string was created successfully
851 * FALSE, Otherwise
853 BOOL WINAPI SHAboutInfoA(LPSTR lpszDest, DWORD dwDestLen)
855 WCHAR buff[2084];
857 TRACE("(%p,%d)\n", lpszDest, dwDestLen);
859 if (lpszDest && SHAboutInfoW(buff, dwDestLen))
861 WideCharToMultiByte(CP_ACP, 0, buff, -1, lpszDest, dwDestLen, NULL, NULL);
862 return TRUE;
864 return FALSE;
867 /*************************************************************************
868 * @ [SHLWAPI.161]
870 * Unicode version of SHAboutInfoA.
872 BOOL WINAPI SHAboutInfoW(LPWSTR lpszDest, DWORD dwDestLen)
874 static const WCHAR szIEKey[] = { 'S','O','F','T','W','A','R','E','\\',
875 'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
876 ' ','E','x','p','l','o','r','e','r','\0' };
877 static const WCHAR szWinNtKey[] = { 'S','O','F','T','W','A','R','E','\\',
878 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s',' ',
879 'N','T','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
880 static const WCHAR szWinKey[] = { 'S','O','F','T','W','A','R','E','\\',
881 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
882 'C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
883 static const WCHAR szRegKey[] = { 'S','O','F','T','W','A','R','E','\\',
884 'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
885 ' ','E','x','p','l','o','r','e','r','\\',
886 'R','e','g','i','s','t','r','a','t','i','o','n','\0' };
887 static const WCHAR szVersion[] = { 'V','e','r','s','i','o','n','\0' };
888 static const WCHAR szCustomized[] = { 'C','u','s','t','o','m','i','z','e','d',
889 'V','e','r','s','i','o','n','\0' };
890 static const WCHAR szOwner[] = { 'R','e','g','i','s','t','e','r','e','d',
891 'O','w','n','e','r','\0' };
892 static const WCHAR szOrg[] = { 'R','e','g','i','s','t','e','r','e','d',
893 'O','r','g','a','n','i','z','a','t','i','o','n','\0' };
894 static const WCHAR szProduct[] = { 'P','r','o','d','u','c','t','I','d','\0' };
895 static const WCHAR szUpdate[] = { 'I','E','A','K',
896 'U','p','d','a','t','e','U','r','l','\0' };
897 static const WCHAR szHelp[] = { 'I','E','A','K',
898 'H','e','l','p','S','t','r','i','n','g','\0' };
899 WCHAR buff[2084];
900 HKEY hReg;
901 DWORD dwType, dwLen;
903 TRACE("(%p,%d)\n", lpszDest, dwDestLen);
905 if (!lpszDest)
906 return FALSE;
908 *lpszDest = '\0';
910 /* Try the NT key first, followed by 95/98 key */
911 if (RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinNtKey, 0, KEY_READ, &hReg) &&
912 RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinKey, 0, KEY_READ, &hReg))
913 return FALSE;
915 /* OS Version */
916 buff[0] = '\0';
917 dwLen = 30;
918 if (!SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey, szVersion, &dwType, buff, &dwLen))
920 DWORD dwStrLen = strlenW(buff);
921 dwLen = 30 - dwStrLen;
922 SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey,
923 szCustomized, &dwType, buff+dwStrLen, &dwLen);
925 StrCatBuffW(lpszDest, buff, dwDestLen);
927 /* ~Registered Owner */
928 buff[0] = '~';
929 dwLen = 256;
930 if (SHGetValueW(hReg, szOwner, 0, &dwType, buff+1, &dwLen))
931 buff[1] = '\0';
932 StrCatBuffW(lpszDest, buff, dwDestLen);
934 /* ~Registered Organization */
935 dwLen = 256;
936 if (SHGetValueW(hReg, szOrg, 0, &dwType, buff+1, &dwLen))
937 buff[1] = '\0';
938 StrCatBuffW(lpszDest, buff, dwDestLen);
940 /* FIXME: Not sure where this number comes from */
941 buff[0] = '~';
942 buff[1] = '0';
943 buff[2] = '\0';
944 StrCatBuffW(lpszDest, buff, dwDestLen);
946 /* ~Product Id */
947 dwLen = 256;
948 if (SHGetValueW(HKEY_LOCAL_MACHINE, szRegKey, szProduct, &dwType, buff+1, &dwLen))
949 buff[1] = '\0';
950 StrCatBuffW(lpszDest, buff, dwDestLen);
952 /* ~IE Update Url */
953 dwLen = 2048;
954 if(SHGetValueW(HKEY_LOCAL_MACHINE, szWinKey, szUpdate, &dwType, buff+1, &dwLen))
955 buff[1] = '\0';
956 StrCatBuffW(lpszDest, buff, dwDestLen);
958 /* ~IE Help String */
959 dwLen = 256;
960 if(SHGetValueW(hReg, szHelp, 0, &dwType, buff+1, &dwLen))
961 buff[1] = '\0';
962 StrCatBuffW(lpszDest, buff, dwDestLen);
964 RegCloseKey(hReg);
965 return TRUE;
968 /*************************************************************************
969 * @ [SHLWAPI.163]
971 * Call IOleCommandTarget_QueryStatus() on an object.
973 * PARAMS
974 * lpUnknown [I] Object supporting the IOleCommandTarget interface
975 * pguidCmdGroup [I] GUID for the command group
976 * cCmds [I]
977 * prgCmds [O] Commands
978 * pCmdText [O] Command text
980 * RETURNS
981 * Success: S_OK.
982 * Failure: E_FAIL, if lpUnknown is NULL.
983 * E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
984 * Otherwise, an error code from IOleCommandTarget_QueryStatus().
986 HRESULT WINAPI IUnknown_QueryStatus(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
987 ULONG cCmds, OLECMD *prgCmds, OLECMDTEXT* pCmdText)
989 HRESULT hRet = E_FAIL;
991 TRACE("(%p,%p,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, cCmds, prgCmds, pCmdText);
993 if (lpUnknown)
995 IOleCommandTarget* lpOle;
997 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
998 (void**)&lpOle);
1000 if (SUCCEEDED(hRet) && lpOle)
1002 hRet = IOleCommandTarget_QueryStatus(lpOle, pguidCmdGroup, cCmds,
1003 prgCmds, pCmdText);
1004 IOleCommandTarget_Release(lpOle);
1007 return hRet;
1010 /*************************************************************************
1011 * @ [SHLWAPI.164]
1013 * Call IOleCommandTarget_Exec() on an object.
1015 * PARAMS
1016 * lpUnknown [I] Object supporting the IOleCommandTarget interface
1017 * pguidCmdGroup [I] GUID for the command group
1019 * RETURNS
1020 * Success: S_OK.
1021 * Failure: E_FAIL, if lpUnknown is NULL.
1022 * E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
1023 * Otherwise, an error code from IOleCommandTarget_Exec().
1025 HRESULT WINAPI IUnknown_Exec(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
1026 DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
1027 VARIANT* pvaOut)
1029 HRESULT hRet = E_FAIL;
1031 TRACE("(%p,%p,%d,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, nCmdID,
1032 nCmdexecopt, pvaIn, pvaOut);
1034 if (lpUnknown)
1036 IOleCommandTarget* lpOle;
1038 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
1039 (void**)&lpOle);
1040 if (SUCCEEDED(hRet) && lpOle)
1042 hRet = IOleCommandTarget_Exec(lpOle, pguidCmdGroup, nCmdID,
1043 nCmdexecopt, pvaIn, pvaOut);
1044 IOleCommandTarget_Release(lpOle);
1047 return hRet;
1050 /*************************************************************************
1051 * @ [SHLWAPI.165]
1053 * Retrieve, modify, and re-set a value from a window.
1055 * PARAMS
1056 * hWnd [I] Window to get value from
1057 * offset [I] Offset of value
1058 * mask [I] Mask for flags
1059 * flags [I] Bits to set in window value
1061 * RETURNS
1062 * The new value as it was set, or 0 if any parameter is invalid.
1064 * NOTES
1065 * Only bits specified in mask are affected - set if present in flags and
1066 * reset otherwise.
1068 LONG WINAPI SHSetWindowBits(HWND hwnd, INT offset, UINT mask, UINT flags)
1070 LONG ret = GetWindowLongW(hwnd, offset);
1071 LONG new_flags = (flags & mask) | (ret & ~mask);
1073 TRACE("%p %d %x %x\n", hwnd, offset, mask, flags);
1075 if (new_flags != ret)
1076 ret = SetWindowLongW(hwnd, offset, new_flags);
1077 return ret;
1080 /*************************************************************************
1081 * @ [SHLWAPI.167]
1083 * Change a window's parent.
1085 * PARAMS
1086 * hWnd [I] Window to change parent of
1087 * hWndParent [I] New parent window
1089 * RETURNS
1090 * The old parent of hWnd.
1092 * NOTES
1093 * If hWndParent is NULL (desktop), the window style is changed to WS_POPUP.
1094 * If hWndParent is NOT NULL then we set the WS_CHILD style.
1096 HWND WINAPI SHSetParentHwnd(HWND hWnd, HWND hWndParent)
1098 TRACE("%p, %p\n", hWnd, hWndParent);
1100 if(GetParent(hWnd) == hWndParent)
1101 return NULL;
1103 if(hWndParent)
1104 SHSetWindowBits(hWnd, GWL_STYLE, WS_CHILD | WS_POPUP, WS_CHILD);
1105 else
1106 SHSetWindowBits(hWnd, GWL_STYLE, WS_CHILD | WS_POPUP, WS_POPUP);
1108 return hWndParent ? SetParent(hWnd, hWndParent) : NULL;
1111 /*************************************************************************
1112 * @ [SHLWAPI.168]
1114 * Locate and advise a connection point in an IConnectionPointContainer object.
1116 * PARAMS
1117 * lpUnkSink [I] Sink for the connection point advise call
1118 * riid [I] REFIID of connection point to advise
1119 * fConnect [I] TRUE = Connection being establisted, FALSE = broken
1120 * lpUnknown [I] Object supporting the IConnectionPointContainer interface
1121 * lpCookie [O] Pointer to connection point cookie
1122 * lppCP [O] Destination for the IConnectionPoint found
1124 * RETURNS
1125 * Success: S_OK. If lppCP is non-NULL, it is filled with the IConnectionPoint
1126 * that was advised. The caller is responsible for releasing it.
1127 * Failure: E_FAIL, if any arguments are invalid.
1128 * E_NOINTERFACE, if lpUnknown isn't an IConnectionPointContainer,
1129 * Or an HRESULT error code if any call fails.
1131 HRESULT WINAPI ConnectToConnectionPoint(IUnknown* lpUnkSink, REFIID riid, BOOL fConnect,
1132 IUnknown* lpUnknown, LPDWORD lpCookie,
1133 IConnectionPoint **lppCP)
1135 HRESULT hRet;
1136 IConnectionPointContainer* lpContainer;
1137 IConnectionPoint *lpCP;
1139 if(!lpUnknown || (fConnect && !lpUnkSink))
1140 return E_FAIL;
1142 if(lppCP)
1143 *lppCP = NULL;
1145 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer,
1146 (void**)&lpContainer);
1147 if (SUCCEEDED(hRet))
1149 hRet = IConnectionPointContainer_FindConnectionPoint(lpContainer, riid, &lpCP);
1151 if (SUCCEEDED(hRet))
1153 if(!fConnect)
1154 hRet = IConnectionPoint_Unadvise(lpCP, *lpCookie);
1155 else
1156 hRet = IConnectionPoint_Advise(lpCP, lpUnkSink, lpCookie);
1158 if (FAILED(hRet))
1159 *lpCookie = 0;
1161 if (lppCP && SUCCEEDED(hRet))
1162 *lppCP = lpCP; /* Caller keeps the interface */
1163 else
1164 IConnectionPoint_Release(lpCP); /* Release it */
1167 IConnectionPointContainer_Release(lpContainer);
1169 return hRet;
1172 /*************************************************************************
1173 * @ [SHLWAPI.169]
1175 * Release an interface and zero a supplied pointer.
1177 * PARAMS
1178 * lpUnknown [I] Object to release
1180 * RETURNS
1181 * Nothing.
1183 void WINAPI IUnknown_AtomicRelease(IUnknown ** lpUnknown)
1185 TRACE("(%p)\n", lpUnknown);
1187 if(!lpUnknown || !*lpUnknown) return;
1189 TRACE("doing Release\n");
1191 IUnknown_Release(*lpUnknown);
1192 *lpUnknown = NULL;
1195 /*************************************************************************
1196 * @ [SHLWAPI.170]
1198 * Skip '//' if present in a string.
1200 * PARAMS
1201 * lpszSrc [I] String to check for '//'
1203 * RETURNS
1204 * Success: The next character after the '//' or the string if not present
1205 * Failure: NULL, if lpszStr is NULL.
1207 LPCSTR WINAPI PathSkipLeadingSlashesA(LPCSTR lpszSrc)
1209 if (lpszSrc && lpszSrc[0] == '/' && lpszSrc[1] == '/')
1210 lpszSrc += 2;
1211 return lpszSrc;
1214 /*************************************************************************
1215 * @ [SHLWAPI.171]
1217 * Check if two interfaces come from the same object.
1219 * PARAMS
1220 * lpInt1 [I] Interface to check against lpInt2.
1221 * lpInt2 [I] Interface to check against lpInt1.
1223 * RETURNS
1224 * TRUE, If the interfaces come from the same object.
1225 * FALSE Otherwise.
1227 BOOL WINAPI SHIsSameObject(IUnknown* lpInt1, IUnknown* lpInt2)
1229 IUnknown *lpUnknown1, *lpUnknown2;
1230 BOOL ret;
1232 TRACE("(%p %p)\n", lpInt1, lpInt2);
1234 if (!lpInt1 || !lpInt2)
1235 return FALSE;
1237 if (lpInt1 == lpInt2)
1238 return TRUE;
1240 if (IUnknown_QueryInterface(lpInt1, &IID_IUnknown, (void**)&lpUnknown1) != S_OK)
1241 return FALSE;
1243 if (IUnknown_QueryInterface(lpInt2, &IID_IUnknown, (void**)&lpUnknown2) != S_OK)
1245 IUnknown_Release(lpUnknown1);
1246 return FALSE;
1249 ret = lpUnknown1 == lpUnknown2;
1251 IUnknown_Release(lpUnknown1);
1252 IUnknown_Release(lpUnknown2);
1254 return ret;
1257 /*************************************************************************
1258 * @ [SHLWAPI.172]
1260 * Get the window handle of an object.
1262 * PARAMS
1263 * lpUnknown [I] Object to get the window handle of
1264 * lphWnd [O] Destination for window handle
1266 * RETURNS
1267 * Success: S_OK. lphWnd contains the objects window handle.
1268 * Failure: An HRESULT error code.
1270 * NOTES
1271 * lpUnknown is expected to support one of the following interfaces:
1272 * IOleWindow(), IInternetSecurityMgrSite(), or IShellView().
1274 HRESULT WINAPI IUnknown_GetWindow(IUnknown *lpUnknown, HWND *lphWnd)
1276 IUnknown *lpOle;
1277 HRESULT hRet = E_FAIL;
1279 TRACE("(%p,%p)\n", lpUnknown, lphWnd);
1281 if (!lpUnknown)
1282 return hRet;
1284 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleWindow, (void**)&lpOle);
1286 if (FAILED(hRet))
1288 hRet = IUnknown_QueryInterface(lpUnknown,&IID_IShellView, (void**)&lpOle);
1290 if (FAILED(hRet))
1292 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInternetSecurityMgrSite,
1293 (void**)&lpOle);
1297 if (SUCCEEDED(hRet))
1299 /* Laziness here - Since GetWindow() is the first method for the above 3
1300 * interfaces, we use the same call for them all.
1302 hRet = IOleWindow_GetWindow((IOleWindow*)lpOle, lphWnd);
1303 IUnknown_Release(lpOle);
1304 if (lphWnd)
1305 TRACE("Returning HWND=%p\n", *lphWnd);
1308 return hRet;
1311 /*************************************************************************
1312 * @ [SHLWAPI.173]
1314 * Call a SetOwner method of IShellService from specified object.
1316 * PARAMS
1317 * iface [I] Object that supports IShellService
1318 * pUnk [I] Argument for the SetOwner call
1320 * RETURNS
1321 * Corresponding return value from last call or E_FAIL for null input
1323 HRESULT WINAPI IUnknown_SetOwner(IUnknown *iface, IUnknown *pUnk)
1325 IShellService *service;
1326 HRESULT hr;
1328 TRACE("(%p, %p)\n", iface, pUnk);
1330 if (!iface) return E_FAIL;
1332 hr = IUnknown_QueryInterface(iface, &IID_IShellService, (void**)&service);
1333 if (hr == S_OK)
1335 hr = IShellService_SetOwner(service, pUnk);
1336 IShellService_Release(service);
1339 return hr;
1342 /*************************************************************************
1343 * @ [SHLWAPI.174]
1345 * Call either IObjectWithSite_SetSite() or IInternetSecurityManager_SetSecuritySite() on
1346 * an object.
1349 HRESULT WINAPI IUnknown_SetSite(
1350 IUnknown *obj, /* [in] OLE object */
1351 IUnknown *site) /* [in] Site interface */
1353 HRESULT hr;
1354 IObjectWithSite *iobjwithsite;
1355 IInternetSecurityManager *isecmgr;
1357 if (!obj) return E_FAIL;
1359 hr = IUnknown_QueryInterface(obj, &IID_IObjectWithSite, (LPVOID *)&iobjwithsite);
1360 TRACE("IID_IObjectWithSite QI ret=%08x, %p\n", hr, iobjwithsite);
1361 if (SUCCEEDED(hr))
1363 hr = IObjectWithSite_SetSite(iobjwithsite, site);
1364 TRACE("done IObjectWithSite_SetSite ret=%08x\n", hr);
1365 IObjectWithSite_Release(iobjwithsite);
1367 else
1369 hr = IUnknown_QueryInterface(obj, &IID_IInternetSecurityManager, (LPVOID *)&isecmgr);
1370 TRACE("IID_IInternetSecurityManager QI ret=%08x, %p\n", hr, isecmgr);
1371 if (FAILED(hr)) return hr;
1373 hr = IInternetSecurityManager_SetSecuritySite(isecmgr, (IInternetSecurityMgrSite *)site);
1374 TRACE("done IInternetSecurityManager_SetSecuritySite ret=%08x\n", hr);
1375 IInternetSecurityManager_Release(isecmgr);
1377 return hr;
1380 /*************************************************************************
1381 * @ [SHLWAPI.175]
1383 * Call IPersist_GetClassID() on an object.
1385 * PARAMS
1386 * lpUnknown [I] Object supporting the IPersist interface
1387 * clsid [O] Destination for Class Id
1389 * RETURNS
1390 * Success: S_OK. lpClassId contains the Class Id requested.
1391 * Failure: E_FAIL, If lpUnknown is NULL,
1392 * E_NOINTERFACE If lpUnknown does not support IPersist,
1393 * Or an HRESULT error code.
1395 HRESULT WINAPI IUnknown_GetClassID(IUnknown *lpUnknown, CLSID *clsid)
1397 IPersist *persist;
1398 HRESULT hr;
1400 TRACE("(%p, %p)\n", lpUnknown, clsid);
1402 if (!lpUnknown)
1404 memset(clsid, 0, sizeof(*clsid));
1405 return E_FAIL;
1408 hr = IUnknown_QueryInterface(lpUnknown, &IID_IPersist, (void**)&persist);
1409 if (hr != S_OK)
1411 hr = IUnknown_QueryInterface(lpUnknown, &IID_IPersistFolder, (void**)&persist);
1412 if (hr != S_OK)
1413 return hr;
1416 hr = IPersist_GetClassID(persist, clsid);
1417 IPersist_Release(persist);
1418 return hr;
1421 /*************************************************************************
1422 * @ [SHLWAPI.176]
1424 * Retrieve a Service Interface from an object.
1426 * PARAMS
1427 * lpUnknown [I] Object to get an IServiceProvider interface from
1428 * sid [I] Service ID for IServiceProvider_QueryService() call
1429 * riid [I] Function requested for QueryService call
1430 * lppOut [O] Destination for the service interface pointer
1432 * RETURNS
1433 * Success: S_OK. lppOut contains an object providing the requested service
1434 * Failure: An HRESULT error code
1436 * NOTES
1437 * lpUnknown is expected to support the IServiceProvider interface.
1439 HRESULT WINAPI IUnknown_QueryService(IUnknown* lpUnknown, REFGUID sid, REFIID riid,
1440 LPVOID *lppOut)
1442 IServiceProvider* pService = NULL;
1443 HRESULT hRet;
1445 if (!lppOut)
1446 return E_FAIL;
1448 *lppOut = NULL;
1450 if (!lpUnknown)
1451 return E_FAIL;
1453 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IServiceProvider,
1454 (LPVOID*)&pService);
1456 if (hRet == S_OK && pService)
1458 TRACE("QueryInterface returned (IServiceProvider*)%p\n", pService);
1460 /* Get a Service interface from the object */
1461 hRet = IServiceProvider_QueryService(pService, sid, riid, lppOut);
1463 TRACE("(IServiceProvider*)%p returned (IUnknown*)%p\n", pService, *lppOut);
1465 IServiceProvider_Release(pService);
1467 return hRet;
1470 /*************************************************************************
1471 * @ [SHLWAPI.484]
1473 * Calls IOleCommandTarget::Exec() for specified service object.
1475 * PARAMS
1476 * lpUnknown [I] Object to get an IServiceProvider interface from
1477 * service [I] Service ID for IServiceProvider_QueryService() call
1478 * group [I] Group ID for IOleCommandTarget::Exec() call
1479 * cmdId [I] Command ID for IOleCommandTarget::Exec() call
1480 * cmdOpt [I] Options flags for command
1481 * pIn [I] Input arguments for command
1482 * pOut [O] Output arguments for command
1484 * RETURNS
1485 * Success: S_OK. lppOut contains an object providing the requested service
1486 * Failure: An HRESULT error code
1488 * NOTES
1489 * lpUnknown is expected to support the IServiceProvider interface.
1491 HRESULT WINAPI IUnknown_QueryServiceExec(IUnknown *lpUnknown, REFIID service,
1492 const GUID *group, DWORD cmdId, DWORD cmdOpt, VARIANT *pIn, VARIANT *pOut)
1494 IOleCommandTarget *target;
1495 HRESULT hr;
1497 TRACE("%p %s %s %d %08x %p %p\n", lpUnknown, debugstr_guid(service),
1498 debugstr_guid(group), cmdId, cmdOpt, pIn, pOut);
1500 hr = IUnknown_QueryService(lpUnknown, service, &IID_IOleCommandTarget, (void**)&target);
1501 if (hr == S_OK)
1503 hr = IOleCommandTarget_Exec(target, group, cmdId, cmdOpt, pIn, pOut);
1504 IOleCommandTarget_Release(target);
1507 TRACE("<-- hr=0x%08x\n", hr);
1509 return hr;
1512 /*************************************************************************
1513 * @ [SHLWAPI.514]
1515 * Calls IProfferService methods to proffer/revoke specified service.
1517 * PARAMS
1518 * lpUnknown [I] Object to get an IServiceProvider interface from
1519 * service [I] Service ID for IProfferService::Proffer/Revoke calls
1520 * pService [I] Service to proffer. If NULL ::Revoke is called
1521 * pCookie [IO] Group ID for IOleCommandTarget::Exec() call
1523 * RETURNS
1524 * Success: S_OK. IProffer method returns S_OK
1525 * Failure: An HRESULT error code
1527 * NOTES
1528 * lpUnknown is expected to support the IServiceProvider interface.
1530 HRESULT WINAPI IUnknown_ProfferService(IUnknown *lpUnknown, REFGUID service, IServiceProvider *pService, DWORD *pCookie)
1532 IProfferService *proffer;
1533 HRESULT hr;
1535 TRACE("%p %s %p %p\n", lpUnknown, debugstr_guid(service), pService, pCookie);
1537 hr = IUnknown_QueryService(lpUnknown, &IID_IProfferService, &IID_IProfferService, (void**)&proffer);
1538 if (hr == S_OK)
1540 if (pService)
1541 hr = IProfferService_ProfferService(proffer, service, pService, pCookie);
1542 else
1544 hr = IProfferService_RevokeService(proffer, *pCookie);
1545 *pCookie = 0;
1548 IProfferService_Release(proffer);
1551 return hr;
1554 /*************************************************************************
1555 * @ [SHLWAPI.479]
1557 * Call an object's UIActivateIO method.
1559 * PARAMS
1560 * unknown [I] Object to call the UIActivateIO method on
1561 * activate [I] Parameter for UIActivateIO call
1562 * msg [I] Parameter for UIActivateIO call
1564 * RETURNS
1565 * Success: Value of UI_ActivateIO call
1566 * Failure: An HRESULT error code
1568 * NOTES
1569 * unknown is expected to support the IInputObject interface.
1571 HRESULT WINAPI IUnknown_UIActivateIO(IUnknown *unknown, BOOL activate, LPMSG msg)
1573 IInputObject* object = NULL;
1574 HRESULT ret;
1576 if (!unknown)
1577 return E_FAIL;
1579 /* Get an IInputObject interface from the object */
1580 ret = IUnknown_QueryInterface(unknown, &IID_IInputObject, (LPVOID*) &object);
1582 if (ret == S_OK)
1584 ret = IInputObject_UIActivateIO(object, activate, msg);
1585 IInputObject_Release(object);
1588 return ret;
1591 /*************************************************************************
1592 * @ [SHLWAPI.177]
1594 * Loads a popup menu.
1596 * PARAMS
1597 * hInst [I] Instance handle
1598 * szName [I] Menu name
1600 * RETURNS
1601 * Success: TRUE.
1602 * Failure: FALSE.
1604 BOOL WINAPI SHLoadMenuPopup(HINSTANCE hInst, LPCWSTR szName)
1606 HMENU hMenu;
1608 TRACE("%p %s\n", hInst, debugstr_w(szName));
1610 if ((hMenu = LoadMenuW(hInst, szName)))
1612 if (GetSubMenu(hMenu, 0))
1613 RemoveMenu(hMenu, 0, MF_BYPOSITION);
1615 DestroyMenu(hMenu);
1616 return TRUE;
1618 return FALSE;
1621 typedef struct _enumWndData
1623 UINT uiMsgId;
1624 WPARAM wParam;
1625 LPARAM lParam;
1626 LRESULT (WINAPI *pfnPost)(HWND,UINT,WPARAM,LPARAM);
1627 } enumWndData;
1629 /* Callback for SHLWAPI_178 */
1630 static BOOL CALLBACK SHLWAPI_EnumChildProc(HWND hWnd, LPARAM lParam)
1632 enumWndData *data = (enumWndData *)lParam;
1634 TRACE("(%p,%p)\n", hWnd, data);
1635 data->pfnPost(hWnd, data->uiMsgId, data->wParam, data->lParam);
1636 return TRUE;
1639 /*************************************************************************
1640 * @ [SHLWAPI.178]
1642 * Send or post a message to every child of a window.
1644 * PARAMS
1645 * hWnd [I] Window whose children will get the messages
1646 * uiMsgId [I] Message Id
1647 * wParam [I] WPARAM of message
1648 * lParam [I] LPARAM of message
1649 * bSend [I] TRUE = Use SendMessageA(), FALSE = Use PostMessageA()
1651 * RETURNS
1652 * Nothing.
1654 * NOTES
1655 * The appropriate ASCII or Unicode function is called for the window.
1657 void WINAPI SHPropagateMessage(HWND hWnd, UINT uiMsgId, WPARAM wParam, LPARAM lParam, BOOL bSend)
1659 enumWndData data;
1661 TRACE("(%p,%u,%ld,%ld,%d)\n", hWnd, uiMsgId, wParam, lParam, bSend);
1663 if(hWnd)
1665 data.uiMsgId = uiMsgId;
1666 data.wParam = wParam;
1667 data.lParam = lParam;
1669 if (bSend)
1670 data.pfnPost = IsWindowUnicode(hWnd) ? (void*)SendMessageW : (void*)SendMessageA;
1671 else
1672 data.pfnPost = IsWindowUnicode(hWnd) ? (void*)PostMessageW : (void*)PostMessageA;
1674 EnumChildWindows(hWnd, SHLWAPI_EnumChildProc, (LPARAM)&data);
1678 /*************************************************************************
1679 * @ [SHLWAPI.180]
1681 * Remove all sub-menus from a menu.
1683 * PARAMS
1684 * hMenu [I] Menu to remove sub-menus from
1686 * RETURNS
1687 * Success: 0. All sub-menus under hMenu are removed
1688 * Failure: -1, if any parameter is invalid
1690 DWORD WINAPI SHRemoveAllSubMenus(HMENU hMenu)
1692 int iItemCount = GetMenuItemCount(hMenu) - 1;
1694 TRACE("%p\n", hMenu);
1696 while (iItemCount >= 0)
1698 HMENU hSubMenu = GetSubMenu(hMenu, iItemCount);
1699 if (hSubMenu)
1700 RemoveMenu(hMenu, iItemCount, MF_BYPOSITION);
1701 iItemCount--;
1703 return iItemCount;
1706 /*************************************************************************
1707 * @ [SHLWAPI.181]
1709 * Enable or disable a menu item.
1711 * PARAMS
1712 * hMenu [I] Menu holding menu item
1713 * uID [I] ID of menu item to enable/disable
1714 * bEnable [I] Whether to enable (TRUE) or disable (FALSE) the item.
1716 * RETURNS
1717 * The return code from EnableMenuItem.
1719 UINT WINAPI SHEnableMenuItem(HMENU hMenu, UINT wItemID, BOOL bEnable)
1721 TRACE("%p, %u, %d\n", hMenu, wItemID, bEnable);
1722 return EnableMenuItem(hMenu, wItemID, bEnable ? MF_ENABLED : MF_GRAYED);
1725 /*************************************************************************
1726 * @ [SHLWAPI.182]
1728 * Check or uncheck a menu item.
1730 * PARAMS
1731 * hMenu [I] Menu holding menu item
1732 * uID [I] ID of menu item to check/uncheck
1733 * bCheck [I] Whether to check (TRUE) or uncheck (FALSE) the item.
1735 * RETURNS
1736 * The return code from CheckMenuItem.
1738 DWORD WINAPI SHCheckMenuItem(HMENU hMenu, UINT uID, BOOL bCheck)
1740 TRACE("%p, %u, %d\n", hMenu, uID, bCheck);
1741 return CheckMenuItem(hMenu, uID, bCheck ? MF_CHECKED : MF_UNCHECKED);
1744 /*************************************************************************
1745 * @ [SHLWAPI.183]
1747 * Register a window class if it isn't already.
1749 * PARAMS
1750 * lpWndClass [I] Window class to register
1752 * RETURNS
1753 * The result of the RegisterClassA call.
1755 DWORD WINAPI SHRegisterClassA(WNDCLASSA *wndclass)
1757 WNDCLASSA wca;
1758 if (GetClassInfoA(wndclass->hInstance, wndclass->lpszClassName, &wca))
1759 return TRUE;
1760 return (DWORD)RegisterClassA(wndclass);
1763 /*************************************************************************
1764 * @ [SHLWAPI.186]
1766 BOOL WINAPI SHSimulateDrop(IDropTarget *pDrop, IDataObject *pDataObj,
1767 DWORD grfKeyState, PPOINTL lpPt, DWORD* pdwEffect)
1769 DWORD dwEffect = DROPEFFECT_LINK | DROPEFFECT_MOVE | DROPEFFECT_COPY;
1770 POINTL pt = { 0, 0 };
1772 TRACE("%p %p 0x%08x %p %p\n", pDrop, pDataObj, grfKeyState, lpPt, pdwEffect);
1774 if (!lpPt)
1775 lpPt = &pt;
1777 if (!pdwEffect)
1778 pdwEffect = &dwEffect;
1780 IDropTarget_DragEnter(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1782 if (*pdwEffect != DROPEFFECT_NONE)
1783 return IDropTarget_Drop(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1785 IDropTarget_DragLeave(pDrop);
1786 return TRUE;
1789 /*************************************************************************
1790 * @ [SHLWAPI.187]
1792 * Call IPersistPropertyBag_Load() on an object.
1794 * PARAMS
1795 * lpUnknown [I] Object supporting the IPersistPropertyBag interface
1796 * lpPropBag [O] Destination for loaded IPropertyBag
1798 * RETURNS
1799 * Success: S_OK.
1800 * Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1802 DWORD WINAPI SHLoadFromPropertyBag(IUnknown *lpUnknown, IPropertyBag* lpPropBag)
1804 IPersistPropertyBag* lpPPBag;
1805 HRESULT hRet = E_FAIL;
1807 TRACE("(%p,%p)\n", lpUnknown, lpPropBag);
1809 if (lpUnknown)
1811 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IPersistPropertyBag,
1812 (void**)&lpPPBag);
1813 if (SUCCEEDED(hRet) && lpPPBag)
1815 hRet = IPersistPropertyBag_Load(lpPPBag, lpPropBag, NULL);
1816 IPersistPropertyBag_Release(lpPPBag);
1819 return hRet;
1822 /*************************************************************************
1823 * @ [SHLWAPI.188]
1825 * Call IOleControlSite_TranslateAccelerator() on an object.
1827 * PARAMS
1828 * lpUnknown [I] Object supporting the IOleControlSite interface.
1829 * lpMsg [I] Key message to be processed.
1830 * dwModifiers [I] Flags containing the state of the modifier keys.
1832 * RETURNS
1833 * Success: S_OK.
1834 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
1836 HRESULT WINAPI IUnknown_TranslateAcceleratorOCS(IUnknown *lpUnknown, LPMSG lpMsg, DWORD dwModifiers)
1838 IOleControlSite* lpCSite = NULL;
1839 HRESULT hRet = E_INVALIDARG;
1841 TRACE("(%p,%p,0x%08x)\n", lpUnknown, lpMsg, dwModifiers);
1842 if (lpUnknown)
1844 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1845 (void**)&lpCSite);
1846 if (SUCCEEDED(hRet) && lpCSite)
1848 hRet = IOleControlSite_TranslateAccelerator(lpCSite, lpMsg, dwModifiers);
1849 IOleControlSite_Release(lpCSite);
1852 return hRet;
1856 /*************************************************************************
1857 * @ [SHLWAPI.189]
1859 * Call IOleControlSite_OnFocus() on an object.
1861 * PARAMS
1862 * lpUnknown [I] Object supporting the IOleControlSite interface.
1863 * fGotFocus [I] Whether focus was gained (TRUE) or lost (FALSE).
1865 * RETURNS
1866 * Success: S_OK.
1867 * Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1869 HRESULT WINAPI IUnknown_OnFocusOCS(IUnknown *lpUnknown, BOOL fGotFocus)
1871 IOleControlSite* lpCSite = NULL;
1872 HRESULT hRet = E_FAIL;
1874 TRACE("(%p, %d)\n", lpUnknown, fGotFocus);
1875 if (lpUnknown)
1877 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1878 (void**)&lpCSite);
1879 if (SUCCEEDED(hRet) && lpCSite)
1881 hRet = IOleControlSite_OnFocus(lpCSite, fGotFocus);
1882 IOleControlSite_Release(lpCSite);
1885 return hRet;
1888 /*************************************************************************
1889 * @ [SHLWAPI.190]
1891 HRESULT WINAPI IUnknown_HandleIRestrict(LPUNKNOWN lpUnknown, PVOID lpArg1,
1892 PVOID lpArg2, PVOID lpArg3, PVOID lpArg4)
1894 /* FIXME: {D12F26B2-D90A-11D0-830D-00AA005B4383} - What object does this represent? */
1895 static const DWORD service_id[] = { 0xd12f26b2, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1896 /* FIXME: {D12F26B1-D90A-11D0-830D-00AA005B4383} - Also Unknown/undocumented */
1897 static const DWORD function_id[] = { 0xd12f26b1, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1898 HRESULT hRet = E_INVALIDARG;
1899 LPUNKNOWN lpUnkInner = NULL; /* FIXME: Real type is unknown */
1901 TRACE("(%p,%p,%p,%p,%p)\n", lpUnknown, lpArg1, lpArg2, lpArg3, lpArg4);
1903 if (lpUnknown && lpArg4)
1905 hRet = IUnknown_QueryService(lpUnknown, (REFGUID)service_id,
1906 (REFGUID)function_id, (void**)&lpUnkInner);
1908 if (SUCCEEDED(hRet) && lpUnkInner)
1910 /* FIXME: The type of service object requested is unknown, however
1911 * testing shows that its first method is called with 4 parameters.
1912 * Fake this by using IParseDisplayName_ParseDisplayName since the
1913 * signature and position in the vtable matches our unknown object type.
1915 hRet = IParseDisplayName_ParseDisplayName((LPPARSEDISPLAYNAME)lpUnkInner,
1916 lpArg1, lpArg2, lpArg3, lpArg4);
1917 IUnknown_Release(lpUnkInner);
1920 return hRet;
1923 /*************************************************************************
1924 * @ [SHLWAPI.192]
1926 * Get a sub-menu from a menu item.
1928 * PARAMS
1929 * hMenu [I] Menu to get sub-menu from
1930 * uID [I] ID of menu item containing sub-menu
1932 * RETURNS
1933 * The sub-menu of the item, or a NULL handle if any parameters are invalid.
1935 HMENU WINAPI SHGetMenuFromID(HMENU hMenu, UINT uID)
1937 MENUITEMINFOW mi;
1939 TRACE("(%p,%u)\n", hMenu, uID);
1941 mi.cbSize = sizeof(mi);
1942 mi.fMask = MIIM_SUBMENU;
1944 if (!GetMenuItemInfoW(hMenu, uID, FALSE, &mi))
1945 return NULL;
1947 return mi.hSubMenu;
1950 /*************************************************************************
1951 * @ [SHLWAPI.193]
1953 * Get the color depth of the primary display.
1955 * PARAMS
1956 * None.
1958 * RETURNS
1959 * The color depth of the primary display.
1961 DWORD WINAPI SHGetCurColorRes(void)
1963 HDC hdc;
1964 DWORD ret;
1966 TRACE("()\n");
1968 hdc = GetDC(0);
1969 ret = GetDeviceCaps(hdc, BITSPIXEL) * GetDeviceCaps(hdc, PLANES);
1970 ReleaseDC(0, hdc);
1971 return ret;
1974 /*************************************************************************
1975 * @ [SHLWAPI.194]
1977 * Wait for a message to arrive, with a timeout.
1979 * PARAMS
1980 * hand [I] Handle to query
1981 * dwTimeout [I] Timeout in ticks or INFINITE to never timeout
1983 * RETURNS
1984 * STATUS_TIMEOUT if no message is received before dwTimeout ticks passes.
1985 * Otherwise returns the value from MsgWaitForMultipleObjectsEx when a
1986 * message is available.
1988 DWORD WINAPI SHWaitForSendMessageThread(HANDLE hand, DWORD dwTimeout)
1990 DWORD dwEndTicks = GetTickCount() + dwTimeout;
1991 DWORD dwRet;
1993 while ((dwRet = MsgWaitForMultipleObjectsEx(1, &hand, dwTimeout, QS_SENDMESSAGE, 0)) == 1)
1995 MSG msg;
1997 PeekMessageW(&msg, NULL, 0, 0, PM_NOREMOVE);
1999 if (dwTimeout != INFINITE)
2001 if ((int)(dwTimeout = dwEndTicks - GetTickCount()) <= 0)
2002 return WAIT_TIMEOUT;
2006 return dwRet;
2009 /*************************************************************************
2010 * @ [SHLWAPI.195]
2012 * Determine if a shell folder can be expanded.
2014 * PARAMS
2015 * lpFolder [I] Parent folder containing the object to test.
2016 * pidl [I] Id of the object to test.
2018 * RETURNS
2019 * Success: S_OK, if the object is expandable, S_FALSE otherwise.
2020 * Failure: E_INVALIDARG, if any argument is invalid.
2022 * NOTES
2023 * If the object to be tested does not expose the IQueryInfo() interface it
2024 * will not be identified as an expandable folder.
2026 HRESULT WINAPI SHIsExpandableFolder(LPSHELLFOLDER lpFolder, LPCITEMIDLIST pidl)
2028 HRESULT hRet = E_INVALIDARG;
2029 IQueryInfo *lpInfo;
2031 if (lpFolder && pidl)
2033 hRet = IShellFolder_GetUIObjectOf(lpFolder, NULL, 1, &pidl, &IID_IQueryInfo,
2034 NULL, (void**)&lpInfo);
2035 if (FAILED(hRet))
2036 hRet = S_FALSE; /* Doesn't expose IQueryInfo */
2037 else
2039 DWORD dwFlags = 0;
2041 /* MSDN states of IQueryInfo_GetInfoFlags() that "This method is not
2042 * currently used". Really? You wouldn't be holding out on me would you?
2044 hRet = IQueryInfo_GetInfoFlags(lpInfo, &dwFlags);
2046 if (SUCCEEDED(hRet))
2048 /* 0x2 is an undocumented flag apparently indicating expandability */
2049 hRet = dwFlags & 0x2 ? S_OK : S_FALSE;
2052 IQueryInfo_Release(lpInfo);
2055 return hRet;
2058 /*************************************************************************
2059 * @ [SHLWAPI.197]
2061 * Blank out a region of text by drawing the background only.
2063 * PARAMS
2064 * hDC [I] Device context to draw in
2065 * pRect [I] Area to draw in
2066 * cRef [I] Color to draw in
2068 * RETURNS
2069 * Nothing.
2071 DWORD WINAPI SHFillRectClr(HDC hDC, LPCRECT pRect, COLORREF cRef)
2073 COLORREF cOldColor = SetBkColor(hDC, cRef);
2074 ExtTextOutA(hDC, 0, 0, ETO_OPAQUE, pRect, 0, 0, 0);
2075 SetBkColor(hDC, cOldColor);
2076 return 0;
2079 /*************************************************************************
2080 * @ [SHLWAPI.198]
2082 * Return the value associated with a key in a map.
2084 * PARAMS
2085 * lpKeys [I] A list of keys of length iLen
2086 * lpValues [I] A list of values associated with lpKeys, of length iLen
2087 * iLen [I] Length of both lpKeys and lpValues
2088 * iKey [I] The key value to look up in lpKeys
2090 * RETURNS
2091 * The value in lpValues associated with iKey, or -1 if iKey is not
2092 * found in lpKeys.
2094 * NOTES
2095 * - If two elements in the map share the same key, this function returns
2096 * the value closest to the start of the map
2097 * - The native version of this function crashes if lpKeys or lpValues is NULL.
2099 int WINAPI SHSearchMapInt(const int *lpKeys, const int *lpValues, int iLen, int iKey)
2101 if (lpKeys && lpValues)
2103 int i = 0;
2105 while (i < iLen)
2107 if (lpKeys[i] == iKey)
2108 return lpValues[i]; /* Found */
2109 i++;
2112 return -1; /* Not found */
2116 /*************************************************************************
2117 * @ [SHLWAPI.199]
2119 * Copy an interface pointer
2121 * PARAMS
2122 * lppDest [O] Destination for copy
2123 * lpUnknown [I] Source for copy
2125 * RETURNS
2126 * Nothing.
2128 VOID WINAPI IUnknown_Set(IUnknown **lppDest, IUnknown *lpUnknown)
2130 TRACE("(%p,%p)\n", lppDest, lpUnknown);
2132 IUnknown_AtomicRelease(lppDest);
2134 if (lpUnknown)
2136 IUnknown_AddRef(lpUnknown);
2137 *lppDest = lpUnknown;
2141 /*************************************************************************
2142 * @ [SHLWAPI.200]
2145 HRESULT WINAPI MayQSForward(IUnknown* lpUnknown, PVOID lpReserved,
2146 REFGUID riidCmdGrp, ULONG cCmds,
2147 OLECMD *prgCmds, OLECMDTEXT* pCmdText)
2149 FIXME("(%p,%p,%p,%d,%p,%p) - stub\n",
2150 lpUnknown, lpReserved, riidCmdGrp, cCmds, prgCmds, pCmdText);
2152 /* FIXME: Calls IsQSForward & IUnknown_QueryStatus */
2153 return DRAGDROP_E_NOTREGISTERED;
2156 /*************************************************************************
2157 * @ [SHLWAPI.201]
2160 HRESULT WINAPI MayExecForward(IUnknown* lpUnknown, INT iUnk, REFGUID pguidCmdGroup,
2161 DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
2162 VARIANT* pvaOut)
2164 FIXME("(%p,%d,%p,%d,%d,%p,%p) - stub!\n", lpUnknown, iUnk, pguidCmdGroup,
2165 nCmdID, nCmdexecopt, pvaIn, pvaOut);
2166 return DRAGDROP_E_NOTREGISTERED;
2169 /*************************************************************************
2170 * @ [SHLWAPI.202]
2173 HRESULT WINAPI IsQSForward(REFGUID pguidCmdGroup,ULONG cCmds, OLECMD *prgCmds)
2175 FIXME("(%p,%d,%p) - stub!\n", pguidCmdGroup, cCmds, prgCmds);
2176 return DRAGDROP_E_NOTREGISTERED;
2179 /*************************************************************************
2180 * @ [SHLWAPI.204]
2182 * Determine if a window is not a child of another window.
2184 * PARAMS
2185 * hParent [I] Suspected parent window
2186 * hChild [I] Suspected child window
2188 * RETURNS
2189 * TRUE: If hChild is a child window of hParent
2190 * FALSE: If hChild is not a child window of hParent, or they are equal
2192 BOOL WINAPI SHIsChildOrSelf(HWND hParent, HWND hChild)
2194 TRACE("(%p,%p)\n", hParent, hChild);
2196 if (!hParent || !hChild)
2197 return TRUE;
2198 else if(hParent == hChild)
2199 return FALSE;
2200 return !IsChild(hParent, hChild);
2203 /*************************************************************************
2204 * FDSA functions. Manage a dynamic array of fixed size memory blocks.
2207 typedef struct
2209 DWORD num_items; /* Number of elements inserted */
2210 void *mem; /* Ptr to array */
2211 DWORD blocks_alloced; /* Number of elements allocated */
2212 BYTE inc; /* Number of elements to grow by when we need to expand */
2213 BYTE block_size; /* Size in bytes of an element */
2214 BYTE flags; /* Flags */
2215 } FDSA_info;
2217 #define FDSA_FLAG_INTERNAL_ALLOC 0x01 /* When set we have allocated mem internally */
2219 /*************************************************************************
2220 * @ [SHLWAPI.208]
2222 * Initialize an FDSA array.
2224 BOOL WINAPI FDSA_Initialize(DWORD block_size, DWORD inc, FDSA_info *info, void *mem,
2225 DWORD init_blocks)
2227 TRACE("(0x%08x 0x%08x %p %p 0x%08x)\n", block_size, inc, info, mem, init_blocks);
2229 if(inc == 0)
2230 inc = 1;
2232 if(mem)
2233 memset(mem, 0, block_size * init_blocks);
2235 info->num_items = 0;
2236 info->inc = inc;
2237 info->mem = mem;
2238 info->blocks_alloced = init_blocks;
2239 info->block_size = block_size;
2240 info->flags = 0;
2242 return TRUE;
2245 /*************************************************************************
2246 * @ [SHLWAPI.209]
2248 * Destroy an FDSA array
2250 BOOL WINAPI FDSA_Destroy(FDSA_info *info)
2252 TRACE("(%p)\n", info);
2254 if(info->flags & FDSA_FLAG_INTERNAL_ALLOC)
2256 HeapFree(GetProcessHeap(), 0, info->mem);
2257 return FALSE;
2260 return TRUE;
2263 /*************************************************************************
2264 * @ [SHLWAPI.210]
2266 * Insert element into an FDSA array
2268 DWORD WINAPI FDSA_InsertItem(FDSA_info *info, DWORD where, const void *block)
2270 TRACE("(%p 0x%08x %p)\n", info, where, block);
2271 if(where > info->num_items)
2272 where = info->num_items;
2274 if(info->num_items >= info->blocks_alloced)
2276 DWORD size = (info->blocks_alloced + info->inc) * info->block_size;
2277 if(info->flags & 0x1)
2278 info->mem = HeapReAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, info->mem, size);
2279 else
2281 void *old_mem = info->mem;
2282 info->mem = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, size);
2283 memcpy(info->mem, old_mem, info->blocks_alloced * info->block_size);
2285 info->blocks_alloced += info->inc;
2286 info->flags |= 0x1;
2289 if(where < info->num_items)
2291 memmove((char*)info->mem + (where + 1) * info->block_size,
2292 (char*)info->mem + where * info->block_size,
2293 (info->num_items - where) * info->block_size);
2295 memcpy((char*)info->mem + where * info->block_size, block, info->block_size);
2297 info->num_items++;
2298 return where;
2301 /*************************************************************************
2302 * @ [SHLWAPI.211]
2304 * Delete an element from an FDSA array.
2306 BOOL WINAPI FDSA_DeleteItem(FDSA_info *info, DWORD where)
2308 TRACE("(%p 0x%08x)\n", info, where);
2310 if(where >= info->num_items)
2311 return FALSE;
2313 if(where < info->num_items - 1)
2315 memmove((char*)info->mem + where * info->block_size,
2316 (char*)info->mem + (where + 1) * info->block_size,
2317 (info->num_items - where - 1) * info->block_size);
2319 memset((char*)info->mem + (info->num_items - 1) * info->block_size,
2320 0, info->block_size);
2321 info->num_items--;
2322 return TRUE;
2325 /*************************************************************************
2326 * @ [SHLWAPI.219]
2328 * Call IUnknown_QueryInterface() on a table of objects.
2330 * RETURNS
2331 * Success: S_OK.
2332 * Failure: E_POINTER or E_NOINTERFACE.
2334 HRESULT WINAPI QISearch(
2335 void *base, /* [in] Table of interfaces */
2336 const QITAB *table, /* [in] Array of REFIIDs and indexes into the table */
2337 REFIID riid, /* [in] REFIID to get interface for */
2338 void **ppv) /* [out] Destination for interface pointer */
2340 HRESULT ret;
2341 IUnknown *a_vtbl;
2342 const QITAB *xmove;
2344 TRACE("(%p %p %s %p)\n", base, table, debugstr_guid(riid), ppv);
2345 if (ppv) {
2346 xmove = table;
2347 while (xmove->piid) {
2348 TRACE("trying (offset %d) %s\n", xmove->dwOffset, debugstr_guid(xmove->piid));
2349 if (IsEqualIID(riid, xmove->piid)) {
2350 a_vtbl = (IUnknown*)(xmove->dwOffset + (LPBYTE)base);
2351 TRACE("matched, returning (%p)\n", a_vtbl);
2352 *ppv = a_vtbl;
2353 IUnknown_AddRef(a_vtbl);
2354 return S_OK;
2356 xmove++;
2359 if (IsEqualIID(riid, &IID_IUnknown)) {
2360 a_vtbl = (IUnknown*)(table->dwOffset + (LPBYTE)base);
2361 TRACE("returning first for IUnknown (%p)\n", a_vtbl);
2362 *ppv = a_vtbl;
2363 IUnknown_AddRef(a_vtbl);
2364 return S_OK;
2366 *ppv = 0;
2367 ret = E_NOINTERFACE;
2368 } else
2369 ret = E_POINTER;
2371 TRACE("-- 0x%08x\n", ret);
2372 return ret;
2375 /*************************************************************************
2376 * @ [SHLWAPI.220]
2378 * Set the Font for a window and the "PropDlgFont" property of the parent window.
2380 * PARAMS
2381 * hWnd [I] Parent Window to set the property
2382 * id [I] Index of child Window to set the Font
2384 * RETURNS
2385 * Success: S_OK
2388 HRESULT WINAPI SHSetDefaultDialogFont(HWND hWnd, INT id)
2390 FIXME("(%p, %d) stub\n", hWnd, id);
2391 return S_OK;
2394 /*************************************************************************
2395 * @ [SHLWAPI.221]
2397 * Remove the "PropDlgFont" property from a window.
2399 * PARAMS
2400 * hWnd [I] Window to remove the property from
2402 * RETURNS
2403 * A handle to the removed property, or NULL if it did not exist.
2405 HANDLE WINAPI SHRemoveDefaultDialogFont(HWND hWnd)
2407 HANDLE hProp;
2409 TRACE("(%p)\n", hWnd);
2411 hProp = GetPropA(hWnd, "PropDlgFont");
2413 if(hProp)
2415 DeleteObject(hProp);
2416 hProp = RemovePropA(hWnd, "PropDlgFont");
2418 return hProp;
2421 /*************************************************************************
2422 * @ [SHLWAPI.236]
2424 * Load the in-process server of a given GUID.
2426 * PARAMS
2427 * refiid [I] GUID of the server to load.
2429 * RETURNS
2430 * Success: A handle to the loaded server dll.
2431 * Failure: A NULL handle.
2433 HMODULE WINAPI SHPinDllOfCLSID(REFIID refiid)
2435 HKEY newkey;
2436 DWORD type, count;
2437 CHAR value[MAX_PATH], string[MAX_PATH];
2439 strcpy(string, "CLSID\\");
2440 SHStringFromGUIDA(refiid, string + 6, sizeof(string)/sizeof(char) - 6);
2441 strcat(string, "\\InProcServer32");
2443 count = MAX_PATH;
2444 RegOpenKeyExA(HKEY_CLASSES_ROOT, string, 0, 1, &newkey);
2445 RegQueryValueExA(newkey, 0, 0, &type, (PBYTE)value, &count);
2446 RegCloseKey(newkey);
2447 return LoadLibraryExA(value, 0, 0);
2450 /*************************************************************************
2451 * @ [SHLWAPI.237]
2453 * Unicode version of SHLWAPI_183.
2455 DWORD WINAPI SHRegisterClassW(WNDCLASSW * lpWndClass)
2457 WNDCLASSW WndClass;
2459 TRACE("(%p %s)\n",lpWndClass->hInstance, debugstr_w(lpWndClass->lpszClassName));
2461 if (GetClassInfoW(lpWndClass->hInstance, lpWndClass->lpszClassName, &WndClass))
2462 return TRUE;
2463 return RegisterClassW(lpWndClass);
2466 /*************************************************************************
2467 * @ [SHLWAPI.238]
2469 * Unregister a list of classes.
2471 * PARAMS
2472 * hInst [I] Application instance that registered the classes
2473 * lppClasses [I] List of class names
2474 * iCount [I] Number of names in lppClasses
2476 * RETURNS
2477 * Nothing.
2479 void WINAPI SHUnregisterClassesA(HINSTANCE hInst, LPCSTR *lppClasses, INT iCount)
2481 WNDCLASSA WndClass;
2483 TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2485 while (iCount > 0)
2487 if (GetClassInfoA(hInst, *lppClasses, &WndClass))
2488 UnregisterClassA(*lppClasses, hInst);
2489 lppClasses++;
2490 iCount--;
2494 /*************************************************************************
2495 * @ [SHLWAPI.239]
2497 * Unicode version of SHUnregisterClassesA.
2499 void WINAPI SHUnregisterClassesW(HINSTANCE hInst, LPCWSTR *lppClasses, INT iCount)
2501 WNDCLASSW WndClass;
2503 TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2505 while (iCount > 0)
2507 if (GetClassInfoW(hInst, *lppClasses, &WndClass))
2508 UnregisterClassW(*lppClasses, hInst);
2509 lppClasses++;
2510 iCount--;
2514 /*************************************************************************
2515 * @ [SHLWAPI.240]
2517 * Call The correct (Ascii/Unicode) default window procedure for a window.
2519 * PARAMS
2520 * hWnd [I] Window to call the default procedure for
2521 * uMessage [I] Message ID
2522 * wParam [I] WPARAM of message
2523 * lParam [I] LPARAM of message
2525 * RETURNS
2526 * The result of calling DefWindowProcA() or DefWindowProcW().
2528 LRESULT CALLBACK SHDefWindowProc(HWND hWnd, UINT uMessage, WPARAM wParam, LPARAM lParam)
2530 if (IsWindowUnicode(hWnd))
2531 return DefWindowProcW(hWnd, uMessage, wParam, lParam);
2532 return DefWindowProcA(hWnd, uMessage, wParam, lParam);
2535 /*************************************************************************
2536 * @ [SHLWAPI.256]
2538 HRESULT WINAPI IUnknown_GetSite(LPUNKNOWN lpUnknown, REFIID iid, PVOID *lppSite)
2540 HRESULT hRet = E_INVALIDARG;
2541 LPOBJECTWITHSITE lpSite = NULL;
2543 TRACE("(%p,%s,%p)\n", lpUnknown, debugstr_guid(iid), lppSite);
2545 if (lpUnknown && iid && lppSite)
2547 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IObjectWithSite,
2548 (void**)&lpSite);
2549 if (SUCCEEDED(hRet) && lpSite)
2551 hRet = IObjectWithSite_GetSite(lpSite, iid, lppSite);
2552 IObjectWithSite_Release(lpSite);
2555 return hRet;
2558 /*************************************************************************
2559 * @ [SHLWAPI.257]
2561 * Create a worker window using CreateWindowExA().
2563 * PARAMS
2564 * wndProc [I] Window procedure
2565 * hWndParent [I] Parent window
2566 * dwExStyle [I] Extra style flags
2567 * dwStyle [I] Style flags
2568 * hMenu [I] Window menu
2569 * wnd_extra [I] Window extra bytes value
2571 * RETURNS
2572 * Success: The window handle of the newly created window.
2573 * Failure: 0.
2575 HWND WINAPI SHCreateWorkerWindowA(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2576 DWORD dwStyle, HMENU hMenu, LONG_PTR wnd_extra)
2578 static const char szClass[] = "WorkerA";
2579 WNDCLASSA wc;
2580 HWND hWnd;
2582 TRACE("(0x%08x, %p, 0x%08x, 0x%08x, %p, 0x%08lx)\n",
2583 wndProc, hWndParent, dwExStyle, dwStyle, hMenu, wnd_extra);
2585 /* Create Window class */
2586 wc.style = 0;
2587 wc.lpfnWndProc = DefWindowProcA;
2588 wc.cbClsExtra = 0;
2589 wc.cbWndExtra = sizeof(LONG_PTR);
2590 wc.hInstance = shlwapi_hInstance;
2591 wc.hIcon = NULL;
2592 wc.hCursor = LoadCursorA(NULL, (LPSTR)IDC_ARROW);
2593 wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2594 wc.lpszMenuName = NULL;
2595 wc.lpszClassName = szClass;
2597 SHRegisterClassA(&wc);
2599 hWnd = CreateWindowExA(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2600 hWndParent, hMenu, shlwapi_hInstance, 0);
2601 if (hWnd)
2603 SetWindowLongPtrW(hWnd, 0, wnd_extra);
2605 if (wndProc) SetWindowLongPtrA(hWnd, GWLP_WNDPROC, wndProc);
2608 return hWnd;
2611 typedef struct tagPOLICYDATA
2613 DWORD policy; /* flags value passed to SHRestricted */
2614 LPCWSTR appstr; /* application str such as "Explorer" */
2615 LPCWSTR keystr; /* name of the actual registry key / policy */
2616 } POLICYDATA, *LPPOLICYDATA;
2618 #define SHELL_NO_POLICY 0xffffffff
2620 /* default shell policy registry key */
2621 static const WCHAR strRegistryPolicyW[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o',
2622 's','o','f','t','\\','W','i','n','d','o','w','s','\\',
2623 'C','u','r','r','e','n','t','V','e','r','s','i','o','n',
2624 '\\','P','o','l','i','c','i','e','s',0};
2626 /*************************************************************************
2627 * @ [SHLWAPI.271]
2629 * Retrieve a policy value from the registry.
2631 * PARAMS
2632 * lpSubKey [I] registry key name
2633 * lpSubName [I] subname of registry key
2634 * lpValue [I] value name of registry value
2636 * RETURNS
2637 * the value associated with the registry key or 0 if not found
2639 DWORD WINAPI SHGetRestriction(LPCWSTR lpSubKey, LPCWSTR lpSubName, LPCWSTR lpValue)
2641 DWORD retval, datsize = sizeof(retval);
2642 HKEY hKey;
2644 if (!lpSubKey)
2645 lpSubKey = strRegistryPolicyW;
2647 retval = RegOpenKeyW(HKEY_LOCAL_MACHINE, lpSubKey, &hKey);
2648 if (retval != ERROR_SUCCESS)
2649 retval = RegOpenKeyW(HKEY_CURRENT_USER, lpSubKey, &hKey);
2650 if (retval != ERROR_SUCCESS)
2651 return 0;
2653 SHGetValueW(hKey, lpSubName, lpValue, NULL, &retval, &datsize);
2654 RegCloseKey(hKey);
2655 return retval;
2658 /*************************************************************************
2659 * @ [SHLWAPI.266]
2661 * Helper function to retrieve the possibly cached value for a specific policy
2663 * PARAMS
2664 * policy [I] The policy to look for
2665 * initial [I] Main registry key to open, if NULL use default
2666 * polTable [I] Table of known policies, 0 terminated
2667 * polArr [I] Cache array of policy values
2669 * RETURNS
2670 * The retrieved policy value or 0 if not successful
2672 * NOTES
2673 * This function is used by the native SHRestricted function to search for the
2674 * policy and cache it once retrieved. The current Wine implementation uses a
2675 * different POLICYDATA structure and implements a similar algorithm adapted to
2676 * that structure.
2678 DWORD WINAPI SHRestrictionLookup(
2679 DWORD policy,
2680 LPCWSTR initial,
2681 LPPOLICYDATA polTable,
2682 LPDWORD polArr)
2684 TRACE("(0x%08x %s %p %p)\n", policy, debugstr_w(initial), polTable, polArr);
2686 if (!polTable || !polArr)
2687 return 0;
2689 for (;polTable->policy; polTable++, polArr++)
2691 if (policy == polTable->policy)
2693 /* we have a known policy */
2695 /* check if this policy has been cached */
2696 if (*polArr == SHELL_NO_POLICY)
2697 *polArr = SHGetRestriction(initial, polTable->appstr, polTable->keystr);
2698 return *polArr;
2701 /* we don't know this policy, return 0 */
2702 TRACE("unknown policy: (%08x)\n", policy);
2703 return 0;
2706 /*************************************************************************
2707 * @ [SHLWAPI.267]
2709 * Get an interface from an object.
2711 * RETURNS
2712 * Success: S_OK. ppv contains the requested interface.
2713 * Failure: An HRESULT error code.
2715 * NOTES
2716 * This QueryInterface asks the inner object for an interface. In case
2717 * of aggregation this request would be forwarded by the inner to the
2718 * outer object. This function asks the inner object directly for the
2719 * interface circumventing the forwarding to the outer object.
2721 HRESULT WINAPI SHWeakQueryInterface(
2722 IUnknown * pUnk, /* [in] Outer object */
2723 IUnknown * pInner, /* [in] Inner object */
2724 IID * riid, /* [in] Interface GUID to query for */
2725 LPVOID* ppv) /* [out] Destination for queried interface */
2727 HRESULT hret = E_NOINTERFACE;
2728 TRACE("(pUnk=%p pInner=%p\n\tIID: %s %p)\n",pUnk,pInner,debugstr_guid(riid), ppv);
2730 *ppv = NULL;
2731 if(pUnk && pInner) {
2732 hret = IUnknown_QueryInterface(pInner, riid, ppv);
2733 if (SUCCEEDED(hret)) IUnknown_Release(pUnk);
2735 TRACE("-- 0x%08x\n", hret);
2736 return hret;
2739 /*************************************************************************
2740 * @ [SHLWAPI.268]
2742 * Move a reference from one interface to another.
2744 * PARAMS
2745 * lpDest [O] Destination to receive the reference
2746 * lppUnknown [O] Source to give up the reference to lpDest
2748 * RETURNS
2749 * Nothing.
2751 VOID WINAPI SHWeakReleaseInterface(IUnknown *lpDest, IUnknown **lppUnknown)
2753 TRACE("(%p,%p)\n", lpDest, lppUnknown);
2755 if (*lppUnknown)
2757 /* Copy Reference*/
2758 IUnknown_AddRef(lpDest);
2759 IUnknown_AtomicRelease(lppUnknown); /* Release existing interface */
2763 /*************************************************************************
2764 * @ [SHLWAPI.269]
2766 * Convert an ASCII string of a CLSID into a CLSID.
2768 * PARAMS
2769 * idstr [I] String representing a CLSID in registry format
2770 * id [O] Destination for the converted CLSID
2772 * RETURNS
2773 * Success: TRUE. id contains the converted CLSID.
2774 * Failure: FALSE.
2776 BOOL WINAPI GUIDFromStringA(LPCSTR idstr, CLSID *id)
2778 WCHAR wClsid[40];
2779 MultiByteToWideChar(CP_ACP, 0, idstr, -1, wClsid, sizeof(wClsid)/sizeof(WCHAR));
2780 return SUCCEEDED(CLSIDFromString(wClsid, id));
2783 /*************************************************************************
2784 * @ [SHLWAPI.270]
2786 * Unicode version of GUIDFromStringA.
2788 BOOL WINAPI GUIDFromStringW(LPCWSTR idstr, CLSID *id)
2790 return SUCCEEDED(CLSIDFromString((LPCOLESTR)idstr, id));
2793 /*************************************************************************
2794 * @ [SHLWAPI.276]
2796 * Determine if the browser is integrated into the shell, and set a registry
2797 * key accordingly.
2799 * PARAMS
2800 * None.
2802 * RETURNS
2803 * 1, If the browser is not integrated.
2804 * 2, If the browser is integrated.
2806 * NOTES
2807 * The key "HKLM\Software\Microsoft\Internet Explorer\IntegratedBrowser" is
2808 * either set to TRUE, or removed depending on whether the browser is deemed
2809 * to be integrated.
2811 DWORD WINAPI WhichPlatform(void)
2813 static const char szIntegratedBrowser[] = "IntegratedBrowser";
2814 static DWORD dwState = 0;
2815 HKEY hKey;
2816 DWORD dwRet, dwData, dwSize;
2817 HMODULE hshell32;
2819 if (dwState)
2820 return dwState;
2822 /* If shell32 exports DllGetVersion(), the browser is integrated */
2823 dwState = 1;
2824 hshell32 = LoadLibraryA("shell32.dll");
2825 if (hshell32)
2827 FARPROC pDllGetVersion;
2828 pDllGetVersion = GetProcAddress(hshell32, "DllGetVersion");
2829 dwState = pDllGetVersion ? 2 : 1;
2830 FreeLibrary(hshell32);
2833 /* Set or delete the key accordingly */
2834 dwRet = RegOpenKeyExA(HKEY_LOCAL_MACHINE,
2835 "Software\\Microsoft\\Internet Explorer", 0,
2836 KEY_ALL_ACCESS, &hKey);
2837 if (!dwRet)
2839 dwRet = RegQueryValueExA(hKey, szIntegratedBrowser, 0, 0,
2840 (LPBYTE)&dwData, &dwSize);
2842 if (!dwRet && dwState == 1)
2844 /* Value exists but browser is not integrated */
2845 RegDeleteValueA(hKey, szIntegratedBrowser);
2847 else if (dwRet && dwState == 2)
2849 /* Browser is integrated but value does not exist */
2850 dwData = TRUE;
2851 RegSetValueExA(hKey, szIntegratedBrowser, 0, REG_DWORD,
2852 (LPBYTE)&dwData, sizeof(dwData));
2854 RegCloseKey(hKey);
2856 return dwState;
2859 /*************************************************************************
2860 * @ [SHLWAPI.278]
2862 * Unicode version of SHCreateWorkerWindowA.
2864 HWND WINAPI SHCreateWorkerWindowW(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2865 DWORD dwStyle, HMENU hMenu, LONG msg_result)
2867 static const WCHAR szClass[] = { 'W', 'o', 'r', 'k', 'e', 'r', 'W', 0 };
2868 WNDCLASSW wc;
2869 HWND hWnd;
2871 TRACE("(0x%08x, %p, 0x%08x, 0x%08x, %p, 0x%08x)\n",
2872 wndProc, hWndParent, dwExStyle, dwStyle, hMenu, msg_result);
2874 /* If our OS is natively ANSI, use the ANSI version */
2875 if (GetVersion() & 0x80000000) /* not NT */
2877 TRACE("fallback to ANSI, ver 0x%08x\n", GetVersion());
2878 return SHCreateWorkerWindowA(wndProc, hWndParent, dwExStyle, dwStyle, hMenu, msg_result);
2881 /* Create Window class */
2882 wc.style = 0;
2883 wc.lpfnWndProc = DefWindowProcW;
2884 wc.cbClsExtra = 0;
2885 wc.cbWndExtra = 4;
2886 wc.hInstance = shlwapi_hInstance;
2887 wc.hIcon = NULL;
2888 wc.hCursor = LoadCursorW(NULL, (LPWSTR)IDC_ARROW);
2889 wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2890 wc.lpszMenuName = NULL;
2891 wc.lpszClassName = szClass;
2893 SHRegisterClassW(&wc);
2895 hWnd = CreateWindowExW(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2896 hWndParent, hMenu, shlwapi_hInstance, 0);
2897 if (hWnd)
2899 SetWindowLongPtrW(hWnd, DWLP_MSGRESULT, msg_result);
2901 if (wndProc) SetWindowLongPtrW(hWnd, GWLP_WNDPROC, wndProc);
2904 return hWnd;
2907 /*************************************************************************
2908 * @ [SHLWAPI.279]
2910 * Get and show a context menu from a shell folder.
2912 * PARAMS
2913 * hWnd [I] Window displaying the shell folder
2914 * lpFolder [I] IShellFolder interface
2915 * lpApidl [I] Id for the particular folder desired
2917 * RETURNS
2918 * Success: S_OK.
2919 * Failure: An HRESULT error code indicating the error.
2921 HRESULT WINAPI SHInvokeDefaultCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl)
2923 TRACE("%p %p %p\n", hWnd, lpFolder, lpApidl);
2924 return SHInvokeCommand(hWnd, lpFolder, lpApidl, 0);
2927 /*************************************************************************
2928 * @ [SHLWAPI.281]
2930 * _SHPackDispParamsV
2932 HRESULT WINAPI SHPackDispParamsV(DISPPARAMS *params, VARIANTARG *args, UINT cnt, __ms_va_list valist)
2934 VARIANTARG *iter;
2936 TRACE("(%p %p %u ...)\n", params, args, cnt);
2938 params->rgvarg = args;
2939 params->rgdispidNamedArgs = NULL;
2940 params->cArgs = cnt;
2941 params->cNamedArgs = 0;
2943 iter = args+cnt;
2945 while(iter-- > args) {
2946 V_VT(iter) = va_arg(valist, enum VARENUM);
2948 TRACE("vt=%d\n", V_VT(iter));
2950 if(V_VT(iter) & VT_BYREF) {
2951 V_BYREF(iter) = va_arg(valist, LPVOID);
2952 } else {
2953 switch(V_VT(iter)) {
2954 case VT_I4:
2955 V_I4(iter) = va_arg(valist, LONG);
2956 break;
2957 case VT_BSTR:
2958 V_BSTR(iter) = va_arg(valist, BSTR);
2959 break;
2960 case VT_DISPATCH:
2961 V_DISPATCH(iter) = va_arg(valist, IDispatch*);
2962 break;
2963 case VT_BOOL:
2964 V_BOOL(iter) = va_arg(valist, int);
2965 break;
2966 case VT_UNKNOWN:
2967 V_UNKNOWN(iter) = va_arg(valist, IUnknown*);
2968 break;
2969 default:
2970 V_VT(iter) = VT_I4;
2971 V_I4(iter) = va_arg(valist, LONG);
2976 return S_OK;
2979 /*************************************************************************
2980 * @ [SHLWAPI.282]
2982 * SHPackDispParams
2984 HRESULT WINAPIV SHPackDispParams(DISPPARAMS *params, VARIANTARG *args, UINT cnt, ...)
2986 __ms_va_list valist;
2987 HRESULT hres;
2989 __ms_va_start(valist, cnt);
2990 hres = SHPackDispParamsV(params, args, cnt, valist);
2991 __ms_va_end(valist);
2992 return hres;
2995 /*************************************************************************
2996 * SHLWAPI_InvokeByIID
2998 * This helper function calls IDispatch::Invoke for each sink
2999 * which implements given iid or IDispatch.
3002 static HRESULT SHLWAPI_InvokeByIID(
3003 IConnectionPoint* iCP,
3004 REFIID iid,
3005 DISPID dispId,
3006 DISPPARAMS* dispParams)
3008 IEnumConnections *enumerator;
3009 CONNECTDATA rgcd;
3010 static DISPPARAMS empty = {NULL, NULL, 0, 0};
3011 DISPPARAMS* params = dispParams;
3013 HRESULT result = IConnectionPoint_EnumConnections(iCP, &enumerator);
3014 if (FAILED(result))
3015 return result;
3017 /* Invoke is never happening with an NULL dispParams */
3018 if (!params)
3019 params = &empty;
3021 while(IEnumConnections_Next(enumerator, 1, &rgcd, NULL)==S_OK)
3023 IDispatch *dispIface;
3024 if ((iid && SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, iid, (LPVOID*)&dispIface))) ||
3025 SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, &IID_IDispatch, (LPVOID*)&dispIface)))
3027 IDispatch_Invoke(dispIface, dispId, &IID_NULL, 0, DISPATCH_METHOD, params, NULL, NULL, NULL);
3028 IDispatch_Release(dispIface);
3030 IUnknown_Release(rgcd.pUnk);
3033 IEnumConnections_Release(enumerator);
3035 return S_OK;
3038 /*************************************************************************
3039 * IConnectionPoint_InvokeWithCancel [SHLWAPI.283]
3041 HRESULT WINAPI IConnectionPoint_InvokeWithCancel( IConnectionPoint* iCP,
3042 DISPID dispId, DISPPARAMS* dispParams,
3043 DWORD unknown1, DWORD unknown2 )
3045 IID iid;
3046 HRESULT result;
3048 FIXME("(%p)->(0x%x %p %x %x) partial stub\n", iCP, dispId, dispParams, unknown1, unknown2);
3050 result = IConnectionPoint_GetConnectionInterface(iCP, &iid);
3051 if (SUCCEEDED(result))
3052 result = SHLWAPI_InvokeByIID(iCP, &iid, dispId, dispParams);
3053 else
3054 result = SHLWAPI_InvokeByIID(iCP, NULL, dispId, dispParams);
3056 return result;
3060 /*************************************************************************
3061 * @ [SHLWAPI.284]
3063 * IConnectionPoint_SimpleInvoke
3065 HRESULT WINAPI IConnectionPoint_SimpleInvoke(
3066 IConnectionPoint* iCP,
3067 DISPID dispId,
3068 DISPPARAMS* dispParams)
3070 IID iid;
3071 HRESULT result;
3073 TRACE("(%p)->(0x%x %p)\n",iCP,dispId,dispParams);
3075 result = IConnectionPoint_GetConnectionInterface(iCP, &iid);
3076 if (SUCCEEDED(result))
3077 result = SHLWAPI_InvokeByIID(iCP, &iid, dispId, dispParams);
3078 else
3079 result = SHLWAPI_InvokeByIID(iCP, NULL, dispId, dispParams);
3081 return result;
3084 /*************************************************************************
3085 * @ [SHLWAPI.285]
3087 * Notify an IConnectionPoint object of changes.
3089 * PARAMS
3090 * lpCP [I] Object to notify
3091 * dispID [I]
3093 * RETURNS
3094 * Success: S_OK.
3095 * Failure: E_NOINTERFACE, if lpCP is NULL or does not support the
3096 * IConnectionPoint interface.
3098 HRESULT WINAPI IConnectionPoint_OnChanged(IConnectionPoint* lpCP, DISPID dispID)
3100 IEnumConnections *lpEnum;
3101 HRESULT hRet = E_NOINTERFACE;
3103 TRACE("(%p,0x%8X)\n", lpCP, dispID);
3105 /* Get an enumerator for the connections */
3106 if (lpCP)
3107 hRet = IConnectionPoint_EnumConnections(lpCP, &lpEnum);
3109 if (SUCCEEDED(hRet))
3111 IPropertyNotifySink *lpSink;
3112 CONNECTDATA connData;
3113 ULONG ulFetched;
3115 /* Call OnChanged() for every notify sink in the connection point */
3116 while (IEnumConnections_Next(lpEnum, 1, &connData, &ulFetched) == S_OK)
3118 if (SUCCEEDED(IUnknown_QueryInterface(connData.pUnk, &IID_IPropertyNotifySink, (void**)&lpSink)) &&
3119 lpSink)
3121 IPropertyNotifySink_OnChanged(lpSink, dispID);
3122 IPropertyNotifySink_Release(lpSink);
3124 IUnknown_Release(connData.pUnk);
3127 IEnumConnections_Release(lpEnum);
3129 return hRet;
3132 /*************************************************************************
3133 * @ [SHLWAPI.286]
3135 * IUnknown_CPContainerInvokeParam
3137 HRESULT WINAPIV IUnknown_CPContainerInvokeParam(
3138 IUnknown *container,
3139 REFIID riid,
3140 DISPID dispId,
3141 VARIANTARG* buffer,
3142 DWORD cParams, ...)
3144 HRESULT result;
3145 IConnectionPoint *iCP;
3146 IConnectionPointContainer *iCPC;
3147 DISPPARAMS dispParams = {buffer, NULL, cParams, 0};
3148 __ms_va_list valist;
3150 if (!container)
3151 return E_NOINTERFACE;
3153 result = IUnknown_QueryInterface(container, &IID_IConnectionPointContainer,(LPVOID*) &iCPC);
3154 if (FAILED(result))
3155 return result;
3157 result = IConnectionPointContainer_FindConnectionPoint(iCPC, riid, &iCP);
3158 IConnectionPointContainer_Release(iCPC);
3159 if(FAILED(result))
3160 return result;
3162 __ms_va_start(valist, cParams);
3163 SHPackDispParamsV(&dispParams, buffer, cParams, valist);
3164 __ms_va_end(valist);
3166 result = SHLWAPI_InvokeByIID(iCP, riid, dispId, &dispParams);
3167 IConnectionPoint_Release(iCP);
3169 return result;
3172 /*************************************************************************
3173 * @ [SHLWAPI.287]
3175 * Notify an IConnectionPointContainer object of changes.
3177 * PARAMS
3178 * lpUnknown [I] Object to notify
3179 * dispID [I]
3181 * RETURNS
3182 * Success: S_OK.
3183 * Failure: E_NOINTERFACE, if lpUnknown is NULL or does not support the
3184 * IConnectionPointContainer interface.
3186 HRESULT WINAPI IUnknown_CPContainerOnChanged(IUnknown *lpUnknown, DISPID dispID)
3188 IConnectionPointContainer* lpCPC = NULL;
3189 HRESULT hRet = E_NOINTERFACE;
3191 TRACE("(%p,0x%8X)\n", lpUnknown, dispID);
3193 if (lpUnknown)
3194 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer, (void**)&lpCPC);
3196 if (SUCCEEDED(hRet))
3198 IConnectionPoint* lpCP;
3200 hRet = IConnectionPointContainer_FindConnectionPoint(lpCPC, &IID_IPropertyNotifySink, &lpCP);
3201 IConnectionPointContainer_Release(lpCPC);
3203 hRet = IConnectionPoint_OnChanged(lpCP, dispID);
3204 IConnectionPoint_Release(lpCP);
3206 return hRet;
3209 /*************************************************************************
3210 * @ [SHLWAPI.289]
3212 * See PlaySoundW.
3214 BOOL WINAPI PlaySoundWrapW(LPCWSTR pszSound, HMODULE hmod, DWORD fdwSound)
3216 return PlaySoundW(pszSound, hmod, fdwSound);
3219 /*************************************************************************
3220 * @ [SHLWAPI.294]
3222 * Retrieve a key value from an INI file. See GetPrivateProfileString for
3223 * more information.
3225 * PARAMS
3226 * appName [I] The section in the INI file that contains the key
3227 * keyName [I] The key to be retrieved
3228 * out [O] The buffer into which the key's value will be copied
3229 * outLen [I] The length of the `out' buffer
3230 * filename [I] The location of the INI file
3232 * RETURNS
3233 * Length of string copied into `out'.
3235 DWORD WINAPI SHGetIniStringW(LPCWSTR appName, LPCWSTR keyName, LPWSTR out,
3236 DWORD outLen, LPCWSTR filename)
3238 INT ret;
3239 WCHAR *buf;
3241 TRACE("(%s,%s,%p,%08x,%s)\n", debugstr_w(appName), debugstr_w(keyName),
3242 out, outLen, debugstr_w(filename));
3244 if(outLen == 0)
3245 return 0;
3247 buf = HeapAlloc(GetProcessHeap(), 0, outLen * sizeof(WCHAR));
3248 if(!buf){
3249 *out = 0;
3250 return 0;
3253 ret = GetPrivateProfileStringW(appName, keyName, NULL, buf, outLen, filename);
3254 if(ret)
3255 strcpyW(out, buf);
3256 else
3257 *out = 0;
3259 HeapFree(GetProcessHeap(), 0, buf);
3261 return strlenW(out);
3264 /*************************************************************************
3265 * @ [SHLWAPI.295]
3267 * Set a key value in an INI file. See WritePrivateProfileString for
3268 * more information.
3270 * PARAMS
3271 * appName [I] The section in the INI file that contains the key
3272 * keyName [I] The key to be set
3273 * str [O] The value of the key
3274 * filename [I] The location of the INI file
3276 * RETURNS
3277 * Success: TRUE
3278 * Failure: FALSE
3280 BOOL WINAPI SHSetIniStringW(LPCWSTR appName, LPCWSTR keyName, LPCWSTR str,
3281 LPCWSTR filename)
3283 TRACE("(%s, %p, %s, %s)\n", debugstr_w(appName), keyName, debugstr_w(str),
3284 debugstr_w(filename));
3286 return WritePrivateProfileStringW(appName, keyName, str, filename);
3289 /*************************************************************************
3290 * @ [SHLWAPI.313]
3292 * See SHGetFileInfoW.
3294 DWORD WINAPI SHGetFileInfoWrapW(LPCWSTR path, DWORD dwFileAttributes,
3295 SHFILEINFOW *psfi, UINT sizeofpsfi, UINT flags)
3297 return SHGetFileInfoW(path, dwFileAttributes, psfi, sizeofpsfi, flags);
3300 /*************************************************************************
3301 * @ [SHLWAPI.318]
3303 * See DragQueryFileW.
3305 UINT WINAPI DragQueryFileWrapW(HDROP hDrop, UINT lFile, LPWSTR lpszFile, UINT lLength)
3307 return DragQueryFileW(hDrop, lFile, lpszFile, lLength);
3310 /*************************************************************************
3311 * @ [SHLWAPI.333]
3313 * See SHBrowseForFolderW.
3315 LPITEMIDLIST WINAPI SHBrowseForFolderWrapW(LPBROWSEINFOW lpBi)
3317 return SHBrowseForFolderW(lpBi);
3320 /*************************************************************************
3321 * @ [SHLWAPI.334]
3323 * See SHGetPathFromIDListW.
3325 BOOL WINAPI SHGetPathFromIDListWrapW(LPCITEMIDLIST pidl,LPWSTR pszPath)
3327 return SHGetPathFromIDListW(pidl, pszPath);
3330 /*************************************************************************
3331 * @ [SHLWAPI.335]
3333 * See ShellExecuteExW.
3335 BOOL WINAPI ShellExecuteExWrapW(LPSHELLEXECUTEINFOW lpExecInfo)
3337 return ShellExecuteExW(lpExecInfo);
3340 /*************************************************************************
3341 * @ [SHLWAPI.336]
3343 * See SHFileOperationW.
3345 INT WINAPI SHFileOperationWrapW(LPSHFILEOPSTRUCTW lpFileOp)
3347 return SHFileOperationW(lpFileOp);
3350 /*************************************************************************
3351 * @ [SHLWAPI.342]
3354 PVOID WINAPI SHInterlockedCompareExchange( PVOID *dest, PVOID xchg, PVOID compare )
3356 return InterlockedCompareExchangePointer( dest, xchg, compare );
3359 /*************************************************************************
3360 * @ [SHLWAPI.350]
3362 * See GetFileVersionInfoSizeW.
3364 DWORD WINAPI GetFileVersionInfoSizeWrapW( LPCWSTR filename, LPDWORD handle )
3366 return GetFileVersionInfoSizeW( filename, handle );
3369 /*************************************************************************
3370 * @ [SHLWAPI.351]
3372 * See GetFileVersionInfoW.
3374 BOOL WINAPI GetFileVersionInfoWrapW( LPCWSTR filename, DWORD handle,
3375 DWORD datasize, LPVOID data )
3377 return GetFileVersionInfoW( filename, handle, datasize, data );
3380 /*************************************************************************
3381 * @ [SHLWAPI.352]
3383 * See VerQueryValueW.
3385 WORD WINAPI VerQueryValueWrapW( LPVOID pBlock, LPCWSTR lpSubBlock,
3386 LPVOID *lplpBuffer, UINT *puLen )
3388 return VerQueryValueW( pBlock, lpSubBlock, lplpBuffer, puLen );
3391 #define IsIface(type) SUCCEEDED((hRet = IUnknown_QueryInterface(lpUnknown, &IID_##type, (void**)&lpObj)))
3392 #define IShellBrowser_EnableModeless IShellBrowser_EnableModelessSB
3393 #define EnableModeless(type) type##_EnableModeless((type*)lpObj, bModeless)
3395 /*************************************************************************
3396 * @ [SHLWAPI.355]
3398 * Change the modality of a shell object.
3400 * PARAMS
3401 * lpUnknown [I] Object to make modeless
3402 * bModeless [I] TRUE=Make modeless, FALSE=Make modal
3404 * RETURNS
3405 * Success: S_OK. The modality lpUnknown is changed.
3406 * Failure: An HRESULT error code indicating the error.
3408 * NOTES
3409 * lpUnknown must support the IOleInPlaceFrame interface, the
3410 * IInternetSecurityMgrSite interface, the IShellBrowser interface
3411 * the IDocHostUIHandler interface, or the IOleInPlaceActiveObject interface,
3412 * or this call will fail.
3414 HRESULT WINAPI IUnknown_EnableModeless(IUnknown *lpUnknown, BOOL bModeless)
3416 IUnknown *lpObj;
3417 HRESULT hRet;
3419 TRACE("(%p,%d)\n", lpUnknown, bModeless);
3421 if (!lpUnknown)
3422 return E_FAIL;
3424 if (IsIface(IOleInPlaceActiveObject))
3425 EnableModeless(IOleInPlaceActiveObject);
3426 else if (IsIface(IOleInPlaceFrame))
3427 EnableModeless(IOleInPlaceFrame);
3428 else if (IsIface(IShellBrowser))
3429 EnableModeless(IShellBrowser);
3430 else if (IsIface(IInternetSecurityMgrSite))
3431 EnableModeless(IInternetSecurityMgrSite);
3432 else if (IsIface(IDocHostUIHandler))
3433 EnableModeless(IDocHostUIHandler);
3434 else
3435 return hRet;
3437 IUnknown_Release(lpObj);
3438 return S_OK;
3441 /*************************************************************************
3442 * @ [SHLWAPI.357]
3444 * See SHGetNewLinkInfoW.
3446 BOOL WINAPI SHGetNewLinkInfoWrapW(LPCWSTR pszLinkTo, LPCWSTR pszDir, LPWSTR pszName,
3447 BOOL *pfMustCopy, UINT uFlags)
3449 return SHGetNewLinkInfoW(pszLinkTo, pszDir, pszName, pfMustCopy, uFlags);
3452 /*************************************************************************
3453 * @ [SHLWAPI.358]
3455 * See SHDefExtractIconW.
3457 UINT WINAPI SHDefExtractIconWrapW(LPCWSTR pszIconFile, int iIndex, UINT uFlags, HICON* phiconLarge,
3458 HICON* phiconSmall, UINT nIconSize)
3460 return SHDefExtractIconW(pszIconFile, iIndex, uFlags, phiconLarge, phiconSmall, nIconSize);
3463 /*************************************************************************
3464 * @ [SHLWAPI.363]
3466 * Get and show a context menu from a shell folder.
3468 * PARAMS
3469 * hWnd [I] Window displaying the shell folder
3470 * lpFolder [I] IShellFolder interface
3471 * lpApidl [I] Id for the particular folder desired
3472 * dwCommandId [I] The command ID to invoke (0=invoke default)
3474 * RETURNS
3475 * Success: S_OK. If bInvokeDefault is TRUE, the default menu action was
3476 * executed.
3477 * Failure: An HRESULT error code indicating the error.
3479 HRESULT WINAPI SHInvokeCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl, DWORD dwCommandId)
3481 IContextMenu *iContext;
3482 HRESULT hRet;
3484 TRACE("(%p, %p, %p, %u)\n", hWnd, lpFolder, lpApidl, dwCommandId);
3486 if (!lpFolder)
3487 return E_FAIL;
3489 /* Get the context menu from the shell folder */
3490 hRet = IShellFolder_GetUIObjectOf(lpFolder, hWnd, 1, &lpApidl,
3491 &IID_IContextMenu, 0, (void**)&iContext);
3492 if (SUCCEEDED(hRet))
3494 HMENU hMenu;
3495 if ((hMenu = CreatePopupMenu()))
3497 HRESULT hQuery;
3499 /* Add the context menu entries to the popup */
3500 hQuery = IContextMenu_QueryContextMenu(iContext, hMenu, 0, 1, 0x7FFF,
3501 dwCommandId ? CMF_NORMAL : CMF_DEFAULTONLY);
3503 if (SUCCEEDED(hQuery))
3505 if (!dwCommandId)
3506 dwCommandId = GetMenuDefaultItem(hMenu, 0, 0);
3507 if (dwCommandId != (UINT)-1)
3509 CMINVOKECOMMANDINFO cmIci;
3510 /* Invoke the default item */
3511 memset(&cmIci,0,sizeof(cmIci));
3512 cmIci.cbSize = sizeof(cmIci);
3513 cmIci.fMask = CMIC_MASK_ASYNCOK;
3514 cmIci.hwnd = hWnd;
3515 cmIci.lpVerb = MAKEINTRESOURCEA(dwCommandId);
3516 cmIci.nShow = SW_SHOWNORMAL;
3518 hRet = IContextMenu_InvokeCommand(iContext, &cmIci);
3521 DestroyMenu(hMenu);
3523 IContextMenu_Release(iContext);
3525 return hRet;
3528 /*************************************************************************
3529 * @ [SHLWAPI.370]
3531 * See ExtractIconW.
3533 HICON WINAPI ExtractIconWrapW(HINSTANCE hInstance, LPCWSTR lpszExeFileName,
3534 UINT nIconIndex)
3536 return ExtractIconW(hInstance, lpszExeFileName, nIconIndex);
3539 /*************************************************************************
3540 * @ [SHLWAPI.377]
3542 * Load a library from the directory of a particular process.
3544 * PARAMS
3545 * new_mod [I] Library name
3546 * inst_hwnd [I] Module whose directory is to be used
3547 * dwCrossCodePage [I] Should be FALSE (currently ignored)
3549 * RETURNS
3550 * Success: A handle to the loaded module
3551 * Failure: A NULL handle.
3553 HMODULE WINAPI MLLoadLibraryA(LPCSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3555 /* FIXME: Native appears to do DPA_Create and a DPA_InsertPtr for
3556 * each call here.
3557 * FIXME: Native shows calls to:
3558 * SHRegGetUSValue for "Software\Microsoft\Internet Explorer\International"
3559 * CheckVersion
3560 * RegOpenKeyExA for "HKLM\Software\Microsoft\Internet Explorer"
3561 * RegQueryValueExA for "LPKInstalled"
3562 * RegCloseKey
3563 * RegOpenKeyExA for "HKCU\Software\Microsoft\Internet Explorer\International"
3564 * RegQueryValueExA for "ResourceLocale"
3565 * RegCloseKey
3566 * RegOpenKeyExA for "HKLM\Software\Microsoft\Active Setup\Installed Components\{guid}"
3567 * RegQueryValueExA for "Locale"
3568 * RegCloseKey
3569 * and then tests the Locale ("en" for me).
3570 * code below
3571 * after the code then a DPA_Create (first time) and DPA_InsertPtr are done.
3573 CHAR mod_path[2*MAX_PATH];
3574 LPSTR ptr;
3575 DWORD len;
3577 FIXME("(%s,%p,%d) semi-stub!\n", debugstr_a(new_mod), inst_hwnd, dwCrossCodePage);
3578 len = GetModuleFileNameA(inst_hwnd, mod_path, sizeof(mod_path));
3579 if (!len || len >= sizeof(mod_path)) return NULL;
3581 ptr = strrchr(mod_path, '\\');
3582 if (ptr) {
3583 strcpy(ptr+1, new_mod);
3584 TRACE("loading %s\n", debugstr_a(mod_path));
3585 return LoadLibraryA(mod_path);
3587 return NULL;
3590 /*************************************************************************
3591 * @ [SHLWAPI.378]
3593 * Unicode version of MLLoadLibraryA.
3595 HMODULE WINAPI MLLoadLibraryW(LPCWSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3597 WCHAR mod_path[2*MAX_PATH];
3598 LPWSTR ptr;
3599 DWORD len;
3601 FIXME("(%s,%p,%d) semi-stub!\n", debugstr_w(new_mod), inst_hwnd, dwCrossCodePage);
3602 len = GetModuleFileNameW(inst_hwnd, mod_path, sizeof(mod_path) / sizeof(WCHAR));
3603 if (!len || len >= sizeof(mod_path) / sizeof(WCHAR)) return NULL;
3605 ptr = strrchrW(mod_path, '\\');
3606 if (ptr) {
3607 strcpyW(ptr+1, new_mod);
3608 TRACE("loading %s\n", debugstr_w(mod_path));
3609 return LoadLibraryW(mod_path);
3611 return NULL;
3614 /*************************************************************************
3615 * ColorAdjustLuma [SHLWAPI.@]
3617 * Adjust the luminosity of a color
3619 * PARAMS
3620 * cRGB [I] RGB value to convert
3621 * dwLuma [I] Luma adjustment
3622 * bUnknown [I] Unknown
3624 * RETURNS
3625 * The adjusted RGB color.
3627 COLORREF WINAPI ColorAdjustLuma(COLORREF cRGB, int dwLuma, BOOL bUnknown)
3629 TRACE("(0x%8x,%d,%d)\n", cRGB, dwLuma, bUnknown);
3631 if (dwLuma)
3633 WORD wH, wL, wS;
3635 ColorRGBToHLS(cRGB, &wH, &wL, &wS);
3637 FIXME("Ignoring luma adjustment\n");
3639 /* FIXME: The adjustment is not linear */
3641 cRGB = ColorHLSToRGB(wH, wL, wS);
3643 return cRGB;
3646 /*************************************************************************
3647 * @ [SHLWAPI.389]
3649 * See GetSaveFileNameW.
3651 BOOL WINAPI GetSaveFileNameWrapW(LPOPENFILENAMEW ofn)
3653 return GetSaveFileNameW(ofn);
3656 /*************************************************************************
3657 * @ [SHLWAPI.390]
3659 * See WNetRestoreConnectionW.
3661 DWORD WINAPI WNetRestoreConnectionWrapW(HWND hwndOwner, LPWSTR lpszDevice)
3663 return WNetRestoreConnectionW(hwndOwner, lpszDevice);
3666 /*************************************************************************
3667 * @ [SHLWAPI.391]
3669 * See WNetGetLastErrorW.
3671 DWORD WINAPI WNetGetLastErrorWrapW(LPDWORD lpError, LPWSTR lpErrorBuf, DWORD nErrorBufSize,
3672 LPWSTR lpNameBuf, DWORD nNameBufSize)
3674 return WNetGetLastErrorW(lpError, lpErrorBuf, nErrorBufSize, lpNameBuf, nNameBufSize);
3677 /*************************************************************************
3678 * @ [SHLWAPI.401]
3680 * See PageSetupDlgW.
3682 BOOL WINAPI PageSetupDlgWrapW(LPPAGESETUPDLGW pagedlg)
3684 return PageSetupDlgW(pagedlg);
3687 /*************************************************************************
3688 * @ [SHLWAPI.402]
3690 * See PrintDlgW.
3692 BOOL WINAPI PrintDlgWrapW(LPPRINTDLGW printdlg)
3694 return PrintDlgW(printdlg);
3697 /*************************************************************************
3698 * @ [SHLWAPI.403]
3700 * See GetOpenFileNameW.
3702 BOOL WINAPI GetOpenFileNameWrapW(LPOPENFILENAMEW ofn)
3704 return GetOpenFileNameW(ofn);
3707 /*************************************************************************
3708 * @ [SHLWAPI.404]
3710 HRESULT WINAPI SHIShellFolder_EnumObjects(LPSHELLFOLDER lpFolder, HWND hwnd, SHCONTF flags, IEnumIDList **ppenum)
3712 /* Windows attempts to get an IPersist interface and, if that fails, an
3713 * IPersistFolder interface on the folder passed-in here. If one of those
3714 * interfaces is available, it then calls GetClassID on the folder... and
3715 * then calls IShellFolder_EnumObjects no matter what, even crashing if
3716 * lpFolder isn't actually an IShellFolder object. The purpose of getting
3717 * the ClassID is unknown, so we don't do it here.
3719 * For discussion and detailed tests, see:
3720 * "shlwapi: Be less strict on which type of IShellFolder can be enumerated"
3721 * wine-devel mailing list, 3 Jun 2010
3724 return IShellFolder_EnumObjects(lpFolder, hwnd, flags, ppenum);
3727 /* INTERNAL: Map from HLS color space to RGB */
3728 static WORD ConvertHue(int wHue, WORD wMid1, WORD wMid2)
3730 wHue = wHue > 240 ? wHue - 240 : wHue < 0 ? wHue + 240 : wHue;
3732 if (wHue > 160)
3733 return wMid1;
3734 else if (wHue > 120)
3735 wHue = 160 - wHue;
3736 else if (wHue > 40)
3737 return wMid2;
3739 return ((wHue * (wMid2 - wMid1) + 20) / 40) + wMid1;
3742 /* Convert to RGB and scale into RGB range (0..255) */
3743 #define GET_RGB(h) (ConvertHue(h, wMid1, wMid2) * 255 + 120) / 240
3745 /*************************************************************************
3746 * ColorHLSToRGB [SHLWAPI.@]
3748 * Convert from hls color space into an rgb COLORREF.
3750 * PARAMS
3751 * wHue [I] Hue amount
3752 * wLuminosity [I] Luminosity amount
3753 * wSaturation [I] Saturation amount
3755 * RETURNS
3756 * A COLORREF representing the converted color.
3758 * NOTES
3759 * Input hls values are constrained to the range (0..240).
3761 COLORREF WINAPI ColorHLSToRGB(WORD wHue, WORD wLuminosity, WORD wSaturation)
3763 WORD wRed;
3765 if (wSaturation)
3767 WORD wGreen, wBlue, wMid1, wMid2;
3769 if (wLuminosity > 120)
3770 wMid2 = wSaturation + wLuminosity - (wSaturation * wLuminosity + 120) / 240;
3771 else
3772 wMid2 = ((wSaturation + 240) * wLuminosity + 120) / 240;
3774 wMid1 = wLuminosity * 2 - wMid2;
3776 wRed = GET_RGB(wHue + 80);
3777 wGreen = GET_RGB(wHue);
3778 wBlue = GET_RGB(wHue - 80);
3780 return RGB(wRed, wGreen, wBlue);
3783 wRed = wLuminosity * 255 / 240;
3784 return RGB(wRed, wRed, wRed);
3787 /*************************************************************************
3788 * @ [SHLWAPI.413]
3790 * Get the current docking status of the system.
3792 * PARAMS
3793 * dwFlags [I] DOCKINFO_ flags from "winbase.h", unused
3795 * RETURNS
3796 * One of DOCKINFO_UNDOCKED, DOCKINFO_UNDOCKED, or 0 if the system is not
3797 * a notebook.
3799 DWORD WINAPI SHGetMachineInfo(DWORD dwFlags)
3801 HW_PROFILE_INFOA hwInfo;
3803 TRACE("(0x%08x)\n", dwFlags);
3805 GetCurrentHwProfileA(&hwInfo);
3806 switch (hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED))
3808 case DOCKINFO_DOCKED:
3809 case DOCKINFO_UNDOCKED:
3810 return hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED);
3811 default:
3812 return 0;
3816 /*************************************************************************
3817 * @ [SHLWAPI.416]
3820 DWORD WINAPI SHWinHelpOnDemandW(HWND hwnd, LPCWSTR helpfile, DWORD flags1, VOID *ptr1, DWORD flags2)
3823 FIXME("(%p, %s, 0x%x, %p, %d)\n", hwnd, debugstr_w(helpfile), flags1, ptr1, flags2);
3824 return 0;
3827 /*************************************************************************
3828 * @ [SHLWAPI.417]
3831 DWORD WINAPI SHWinHelpOnDemandA(HWND hwnd, LPCSTR helpfile, DWORD flags1, VOID *ptr1, DWORD flags2)
3834 FIXME("(%p, %s, 0x%x, %p, %d)\n", hwnd, debugstr_a(helpfile), flags1, ptr1, flags2);
3835 return 0;
3838 /*************************************************************************
3839 * @ [SHLWAPI.418]
3841 * Function seems to do FreeLibrary plus other things.
3843 * FIXME native shows the following calls:
3844 * RtlEnterCriticalSection
3845 * LocalFree
3846 * GetProcAddress(Comctl32??, 150L)
3847 * DPA_DeletePtr
3848 * RtlLeaveCriticalSection
3849 * followed by the FreeLibrary.
3850 * The above code may be related to .377 above.
3852 BOOL WINAPI MLFreeLibrary(HMODULE hModule)
3854 FIXME("(%p) semi-stub\n", hModule);
3855 return FreeLibrary(hModule);
3858 /*************************************************************************
3859 * @ [SHLWAPI.419]
3861 BOOL WINAPI SHFlushSFCacheWrap(void) {
3862 FIXME(": stub\n");
3863 return TRUE;
3866 /*************************************************************************
3867 * @ [SHLWAPI.429]
3868 * FIXME I have no idea what this function does or what its arguments are.
3870 BOOL WINAPI MLIsMLHInstance(HINSTANCE hInst)
3872 FIXME("(%p) stub\n", hInst);
3873 return FALSE;
3877 /*************************************************************************
3878 * @ [SHLWAPI.430]
3880 DWORD WINAPI MLSetMLHInstance(HINSTANCE hInst, HANDLE hHeap)
3882 FIXME("(%p,%p) stub\n", hInst, hHeap);
3883 return E_FAIL; /* This is what is used if shlwapi not loaded */
3886 /*************************************************************************
3887 * @ [SHLWAPI.431]
3889 DWORD WINAPI MLClearMLHInstance(DWORD x)
3891 FIXME("(0x%08x)stub\n", x);
3892 return 0xabba1247;
3895 /*************************************************************************
3896 * @ [SHLWAPI.432]
3898 * See SHSendMessageBroadcastW
3901 DWORD WINAPI SHSendMessageBroadcastA(UINT uMsg, WPARAM wParam, LPARAM lParam)
3903 return SendMessageTimeoutA(HWND_BROADCAST, uMsg, wParam, lParam,
3904 SMTO_ABORTIFHUNG, 2000, NULL);
3907 /*************************************************************************
3908 * @ [SHLWAPI.433]
3910 * A wrapper for sending Broadcast Messages to all top level Windows
3913 DWORD WINAPI SHSendMessageBroadcastW(UINT uMsg, WPARAM wParam, LPARAM lParam)
3915 return SendMessageTimeoutW(HWND_BROADCAST, uMsg, wParam, lParam,
3916 SMTO_ABORTIFHUNG, 2000, NULL);
3919 /*************************************************************************
3920 * @ [SHLWAPI.436]
3922 * Convert a Unicode string CLSID into a CLSID.
3924 * PARAMS
3925 * idstr [I] string containing a CLSID in text form
3926 * id [O] CLSID extracted from the string
3928 * RETURNS
3929 * S_OK on success or E_INVALIDARG on failure
3931 HRESULT WINAPI CLSIDFromStringWrap(LPCWSTR idstr, CLSID *id)
3933 return CLSIDFromString((LPCOLESTR)idstr, id);
3936 /*************************************************************************
3937 * @ [SHLWAPI.437]
3939 * Determine if the OS supports a given feature.
3941 * PARAMS
3942 * dwFeature [I] Feature requested (undocumented)
3944 * RETURNS
3945 * TRUE If the feature is available.
3946 * FALSE If the feature is not available.
3948 BOOL WINAPI IsOS(DWORD feature)
3950 OSVERSIONINFOA osvi;
3951 DWORD platform, majorv, minorv;
3953 osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOA);
3954 if(!GetVersionExA(&osvi)) {
3955 ERR("GetVersionEx failed\n");
3956 return FALSE;
3959 majorv = osvi.dwMajorVersion;
3960 minorv = osvi.dwMinorVersion;
3961 platform = osvi.dwPlatformId;
3963 #define ISOS_RETURN(x) \
3964 TRACE("(0x%x) ret=%d\n",feature,(x)); \
3965 return (x);
3967 switch(feature) {
3968 case OS_WIN32SORGREATER:
3969 ISOS_RETURN(platform == VER_PLATFORM_WIN32s
3970 || platform == VER_PLATFORM_WIN32_WINDOWS)
3971 case OS_NT:
3972 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3973 case OS_WIN95ORGREATER:
3974 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS)
3975 case OS_NT4ORGREATER:
3976 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 4)
3977 case OS_WIN2000ORGREATER_ALT:
3978 case OS_WIN2000ORGREATER:
3979 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3980 case OS_WIN98ORGREATER:
3981 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 10)
3982 case OS_WIN98_GOLD:
3983 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 10)
3984 case OS_WIN2000PRO:
3985 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3986 case OS_WIN2000SERVER:
3987 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3988 case OS_WIN2000ADVSERVER:
3989 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3990 case OS_WIN2000DATACENTER:
3991 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3992 case OS_WIN2000TERMINAL:
3993 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3994 case OS_EMBEDDED:
3995 FIXME("(OS_EMBEDDED) What should we return here?\n");
3996 return FALSE;
3997 case OS_TERMINALCLIENT:
3998 FIXME("(OS_TERMINALCLIENT) What should we return here?\n");
3999 return FALSE;
4000 case OS_TERMINALREMOTEADMIN:
4001 FIXME("(OS_TERMINALREMOTEADMIN) What should we return here?\n");
4002 return FALSE;
4003 case OS_WIN95_GOLD:
4004 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 0)
4005 case OS_MEORGREATER:
4006 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 90)
4007 case OS_XPORGREATER:
4008 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
4009 case OS_HOME:
4010 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
4011 case OS_PROFESSIONAL:
4012 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4013 case OS_DATACENTER:
4014 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4015 case OS_ADVSERVER:
4016 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
4017 case OS_SERVER:
4018 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4019 case OS_TERMINALSERVER:
4020 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4021 case OS_PERSONALTERMINALSERVER:
4022 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && minorv >= 1 && majorv >= 5)
4023 case OS_FASTUSERSWITCHING:
4024 FIXME("(OS_FASTUSERSWITCHING) What should we return here?\n");
4025 return TRUE;
4026 case OS_WELCOMELOGONUI:
4027 FIXME("(OS_WELCOMELOGONUI) What should we return here?\n");
4028 return FALSE;
4029 case OS_DOMAINMEMBER:
4030 FIXME("(OS_DOMAINMEMBER) What should we return here?\n");
4031 return TRUE;
4032 case OS_ANYSERVER:
4033 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4034 case OS_WOW6432:
4036 BOOL is_wow64;
4037 IsWow64Process(GetCurrentProcess(), &is_wow64);
4038 return is_wow64;
4040 case OS_WEBSERVER:
4041 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4042 case OS_SMALLBUSINESSSERVER:
4043 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
4044 case OS_TABLETPC:
4045 FIXME("(OS_TABLEPC) What should we return here?\n");
4046 return FALSE;
4047 case OS_SERVERADMINUI:
4048 FIXME("(OS_SERVERADMINUI) What should we return here?\n");
4049 return FALSE;
4050 case OS_MEDIACENTER:
4051 FIXME("(OS_MEDIACENTER) What should we return here?\n");
4052 return FALSE;
4053 case OS_APPLIANCE:
4054 FIXME("(OS_APPLIANCE) What should we return here?\n");
4055 return FALSE;
4056 case 0x25: /*OS_VISTAORGREATER*/
4057 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 6)
4060 #undef ISOS_RETURN
4062 WARN("(0x%x) unknown parameter\n",feature);
4064 return FALSE;
4067 /*************************************************************************
4068 * @ [SHLWAPI.439]
4070 HRESULT WINAPI SHLoadRegUIStringW(HKEY hkey, LPCWSTR value, LPWSTR buf, DWORD size)
4072 DWORD type, sz = size;
4074 if(RegQueryValueExW(hkey, value, NULL, &type, (LPBYTE)buf, &sz) != ERROR_SUCCESS)
4075 return E_FAIL;
4077 return SHLoadIndirectString(buf, buf, size, NULL);
4080 /*************************************************************************
4081 * @ [SHLWAPI.478]
4083 * Call IInputObject_TranslateAcceleratorIO() on an object.
4085 * PARAMS
4086 * lpUnknown [I] Object supporting the IInputObject interface.
4087 * lpMsg [I] Key message to be processed.
4089 * RETURNS
4090 * Success: S_OK.
4091 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
4093 HRESULT WINAPI IUnknown_TranslateAcceleratorIO(IUnknown *lpUnknown, LPMSG lpMsg)
4095 IInputObject* lpInput = NULL;
4096 HRESULT hRet = E_INVALIDARG;
4098 TRACE("(%p,%p)\n", lpUnknown, lpMsg);
4099 if (lpUnknown)
4101 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
4102 (void**)&lpInput);
4103 if (SUCCEEDED(hRet) && lpInput)
4105 hRet = IInputObject_TranslateAcceleratorIO(lpInput, lpMsg);
4106 IInputObject_Release(lpInput);
4109 return hRet;
4112 /*************************************************************************
4113 * @ [SHLWAPI.481]
4115 * Call IInputObject_HasFocusIO() on an object.
4117 * PARAMS
4118 * lpUnknown [I] Object supporting the IInputObject interface.
4120 * RETURNS
4121 * Success: S_OK, if lpUnknown is an IInputObject object and has the focus,
4122 * or S_FALSE otherwise.
4123 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
4125 HRESULT WINAPI IUnknown_HasFocusIO(IUnknown *lpUnknown)
4127 IInputObject* lpInput = NULL;
4128 HRESULT hRet = E_INVALIDARG;
4130 TRACE("(%p)\n", lpUnknown);
4131 if (lpUnknown)
4133 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
4134 (void**)&lpInput);
4135 if (SUCCEEDED(hRet) && lpInput)
4137 hRet = IInputObject_HasFocusIO(lpInput);
4138 IInputObject_Release(lpInput);
4141 return hRet;
4144 /*************************************************************************
4145 * ColorRGBToHLS [SHLWAPI.@]
4147 * Convert an rgb COLORREF into the hls color space.
4149 * PARAMS
4150 * cRGB [I] Source rgb value
4151 * pwHue [O] Destination for converted hue
4152 * pwLuminance [O] Destination for converted luminance
4153 * pwSaturation [O] Destination for converted saturation
4155 * RETURNS
4156 * Nothing. pwHue, pwLuminance and pwSaturation are set to the converted
4157 * values.
4159 * NOTES
4160 * Output HLS values are constrained to the range (0..240).
4161 * For Achromatic conversions, Hue is set to 160.
4163 VOID WINAPI ColorRGBToHLS(COLORREF cRGB, LPWORD pwHue,
4164 LPWORD pwLuminance, LPWORD pwSaturation)
4166 int wR, wG, wB, wMax, wMin, wHue, wLuminosity, wSaturation;
4168 TRACE("(%08x,%p,%p,%p)\n", cRGB, pwHue, pwLuminance, pwSaturation);
4170 wR = GetRValue(cRGB);
4171 wG = GetGValue(cRGB);
4172 wB = GetBValue(cRGB);
4174 wMax = max(wR, max(wG, wB));
4175 wMin = min(wR, min(wG, wB));
4177 /* Luminosity */
4178 wLuminosity = ((wMax + wMin) * 240 + 255) / 510;
4180 if (wMax == wMin)
4182 /* Achromatic case */
4183 wSaturation = 0;
4184 /* Hue is now unrepresentable, but this is what native returns... */
4185 wHue = 160;
4187 else
4189 /* Chromatic case */
4190 int wDelta = wMax - wMin, wRNorm, wGNorm, wBNorm;
4192 /* Saturation */
4193 if (wLuminosity <= 120)
4194 wSaturation = ((wMax + wMin)/2 + wDelta * 240) / (wMax + wMin);
4195 else
4196 wSaturation = ((510 - wMax - wMin)/2 + wDelta * 240) / (510 - wMax - wMin);
4198 /* Hue */
4199 wRNorm = (wDelta/2 + wMax * 40 - wR * 40) / wDelta;
4200 wGNorm = (wDelta/2 + wMax * 40 - wG * 40) / wDelta;
4201 wBNorm = (wDelta/2 + wMax * 40 - wB * 40) / wDelta;
4203 if (wR == wMax)
4204 wHue = wBNorm - wGNorm;
4205 else if (wG == wMax)
4206 wHue = 80 + wRNorm - wBNorm;
4207 else
4208 wHue = 160 + wGNorm - wRNorm;
4209 if (wHue < 0)
4210 wHue += 240;
4211 else if (wHue > 240)
4212 wHue -= 240;
4214 if (pwHue)
4215 *pwHue = wHue;
4216 if (pwLuminance)
4217 *pwLuminance = wLuminosity;
4218 if (pwSaturation)
4219 *pwSaturation = wSaturation;
4222 /*************************************************************************
4223 * SHCreateShellPalette [SHLWAPI.@]
4225 HPALETTE WINAPI SHCreateShellPalette(HDC hdc)
4227 FIXME("stub\n");
4228 return CreateHalftonePalette(hdc);
4231 /*************************************************************************
4232 * SHGetInverseCMAP (SHLWAPI.@)
4234 * Get an inverse color map table.
4236 * PARAMS
4237 * lpCmap [O] Destination for color map
4238 * dwSize [I] Size of memory pointed to by lpCmap
4240 * RETURNS
4241 * Success: S_OK.
4242 * Failure: E_POINTER, If lpCmap is invalid.
4243 * E_INVALIDARG, If dwFlags is invalid
4244 * E_OUTOFMEMORY, If there is no memory available
4246 * NOTES
4247 * dwSize may only be CMAP_PTR_SIZE (4) or CMAP_SIZE (8192).
4248 * If dwSize = CMAP_PTR_SIZE, *lpCmap is set to the address of this DLL's
4249 * internal CMap.
4250 * If dwSize = CMAP_SIZE, lpCmap is filled with a copy of the data from
4251 * this DLL's internal CMap.
4253 HRESULT WINAPI SHGetInverseCMAP(LPDWORD dest, DWORD dwSize)
4255 if (dwSize == 4) {
4256 FIXME(" - returning bogus address for SHGetInverseCMAP\n");
4257 *dest = (DWORD)0xabba1249;
4258 return 0;
4260 FIXME("(%p, %#x) stub\n", dest, dwSize);
4261 return 0;
4264 /*************************************************************************
4265 * SHIsLowMemoryMachine [SHLWAPI.@]
4267 * Determine if the current computer has low memory.
4269 * PARAMS
4270 * x [I] FIXME
4272 * RETURNS
4273 * TRUE if the users machine has 16 Megabytes of memory or less,
4274 * FALSE otherwise.
4276 BOOL WINAPI SHIsLowMemoryMachine (DWORD x)
4278 FIXME("(0x%08x) stub\n", x);
4279 return FALSE;
4282 /*************************************************************************
4283 * GetMenuPosFromID [SHLWAPI.@]
4285 * Return the position of a menu item from its Id.
4287 * PARAMS
4288 * hMenu [I] Menu containing the item
4289 * wID [I] Id of the menu item
4291 * RETURNS
4292 * Success: The index of the menu item in hMenu.
4293 * Failure: -1, If the item is not found.
4295 INT WINAPI GetMenuPosFromID(HMENU hMenu, UINT wID)
4297 MENUITEMINFOW mi;
4298 INT nCount = GetMenuItemCount(hMenu), nIter = 0;
4300 TRACE("%p %u\n", hMenu, wID);
4302 while (nIter < nCount)
4304 mi.cbSize = sizeof(mi);
4305 mi.fMask = MIIM_ID;
4306 if (GetMenuItemInfoW(hMenu, nIter, TRUE, &mi) && mi.wID == wID)
4308 TRACE("ret %d\n", nIter);
4309 return nIter;
4311 nIter++;
4314 return -1;
4317 /*************************************************************************
4318 * @ [SHLWAPI.179]
4320 * Same as SHLWAPI.GetMenuPosFromID
4322 DWORD WINAPI SHMenuIndexFromID(HMENU hMenu, UINT uID)
4324 TRACE("%p %u\n", hMenu, uID);
4325 return GetMenuPosFromID(hMenu, uID);
4329 /*************************************************************************
4330 * @ [SHLWAPI.448]
4332 VOID WINAPI FixSlashesAndColonW(LPWSTR lpwstr)
4334 while (*lpwstr)
4336 if (*lpwstr == '/')
4337 *lpwstr = '\\';
4338 lpwstr++;
4343 /*************************************************************************
4344 * @ [SHLWAPI.461]
4346 DWORD WINAPI SHGetAppCompatFlags(DWORD dwUnknown)
4348 FIXME("(0x%08x) stub\n", dwUnknown);
4349 return 0;
4353 /*************************************************************************
4354 * @ [SHLWAPI.549]
4356 HRESULT WINAPI SHCoCreateInstanceAC(REFCLSID rclsid, LPUNKNOWN pUnkOuter,
4357 DWORD dwClsContext, REFIID iid, LPVOID *ppv)
4359 return CoCreateInstance(rclsid, pUnkOuter, dwClsContext, iid, ppv);
4362 /*************************************************************************
4363 * SHSkipJunction [SHLWAPI.@]
4365 * Determine if a bind context can be bound to an object
4367 * PARAMS
4368 * pbc [I] Bind context to check
4369 * pclsid [I] CLSID of object to be bound to
4371 * RETURNS
4372 * TRUE: If it is safe to bind
4373 * FALSE: If pbc is invalid or binding would not be safe
4376 BOOL WINAPI SHSkipJunction(IBindCtx *pbc, const CLSID *pclsid)
4378 static WCHAR szSkipBinding[] = { 'S','k','i','p',' ',
4379 'B','i','n','d','i','n','g',' ','C','L','S','I','D','\0' };
4380 BOOL bRet = FALSE;
4382 if (pbc)
4384 IUnknown* lpUnk;
4386 if (SUCCEEDED(IBindCtx_GetObjectParam(pbc, szSkipBinding, &lpUnk)))
4388 CLSID clsid;
4390 if (SUCCEEDED(IUnknown_GetClassID(lpUnk, &clsid)) &&
4391 IsEqualGUID(pclsid, &clsid))
4392 bRet = TRUE;
4394 IUnknown_Release(lpUnk);
4397 return bRet;
4400 /***********************************************************************
4401 * SHGetShellKey (SHLWAPI.491)
4403 HKEY WINAPI SHGetShellKey(DWORD flags, LPCWSTR sub_key, BOOL create)
4405 enum _shellkey_flags {
4406 SHKEY_Root_HKCU = 0x1,
4407 SHKEY_Root_HKLM = 0x2,
4408 SHKEY_Key_Explorer = 0x00,
4409 SHKEY_Key_Shell = 0x10,
4410 SHKEY_Key_ShellNoRoam = 0x20,
4411 SHKEY_Key_Classes = 0x30,
4412 SHKEY_Subkey_Default = 0x0000,
4413 SHKEY_Subkey_ResourceName = 0x1000,
4414 SHKEY_Subkey_Handlers = 0x2000,
4415 SHKEY_Subkey_Associations = 0x3000,
4416 SHKEY_Subkey_Volatile = 0x4000,
4417 SHKEY_Subkey_MUICache = 0x5000,
4418 SHKEY_Subkey_FileExts = 0x6000
4421 static const WCHAR explorerW[] = {'S','o','f','t','w','a','r','e','\\',
4422 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
4423 'C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\',
4424 'E','x','p','l','o','r','e','r','\\'};
4425 static const WCHAR shellW[] = {'S','o','f','t','w','a','r','e','\\',
4426 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
4427 'S','h','e','l','l','\\'};
4428 static const WCHAR shell_no_roamW[] = {'S','o','f','t','w','a','r','e','\\',
4429 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
4430 'S','h','e','l','l','N','o','R','o','a','m','\\'};
4431 static const WCHAR classesW[] = {'S','o','f','t','w','a','r','e','\\',
4432 'C','l','a','s','s','e','s','\\'};
4434 static const WCHAR localized_resource_nameW[] = {'L','o','c','a','l','i','z','e','d',
4435 'R','e','s','o','u','r','c','e','N','a','m','e','\\'};
4436 static const WCHAR handlersW[] = {'H','a','n','d','l','e','r','s','\\'};
4437 static const WCHAR associationsW[] = {'A','s','s','o','c','i','a','t','i','o','n','s','\\'};
4438 static const WCHAR volatileW[] = {'V','o','l','a','t','i','l','e','\\'};
4439 static const WCHAR mui_cacheW[] = {'M','U','I','C','a','c','h','e','\\'};
4440 static const WCHAR file_extsW[] = {'F','i','l','e','E','x','t','s','\\'};
4442 WCHAR *path;
4443 const WCHAR *key, *subkey;
4444 int size_key, size_subkey, size_user;
4445 HKEY hkey = NULL;
4447 TRACE("(0x%08x, %s, %d)\n", flags, debugstr_w(sub_key), create);
4449 /* For compatibility with Vista+ */
4450 if(flags == 0x1ffff)
4451 flags = 0x21;
4453 switch(flags&0xff0) {
4454 case SHKEY_Key_Explorer:
4455 key = explorerW;
4456 size_key = sizeof(explorerW);
4457 break;
4458 case SHKEY_Key_Shell:
4459 key = shellW;
4460 size_key = sizeof(shellW);
4461 break;
4462 case SHKEY_Key_ShellNoRoam:
4463 key = shell_no_roamW;
4464 size_key = sizeof(shell_no_roamW);
4465 break;
4466 case SHKEY_Key_Classes:
4467 key = classesW;
4468 size_key = sizeof(classesW);
4469 break;
4470 default:
4471 FIXME("unsupported flags (0x%08x)\n", flags);
4472 return NULL;
4475 switch(flags&0xff000) {
4476 case SHKEY_Subkey_Default:
4477 subkey = NULL;
4478 size_subkey = 0;
4479 break;
4480 case SHKEY_Subkey_ResourceName:
4481 subkey = localized_resource_nameW;
4482 size_subkey = sizeof(localized_resource_nameW);
4483 break;
4484 case SHKEY_Subkey_Handlers:
4485 subkey = handlersW;
4486 size_subkey = sizeof(handlersW);
4487 break;
4488 case SHKEY_Subkey_Associations:
4489 subkey = associationsW;
4490 size_subkey = sizeof(associationsW);
4491 break;
4492 case SHKEY_Subkey_Volatile:
4493 subkey = volatileW;
4494 size_subkey = sizeof(volatileW);
4495 break;
4496 case SHKEY_Subkey_MUICache:
4497 subkey = mui_cacheW;
4498 size_subkey = sizeof(mui_cacheW);
4499 break;
4500 case SHKEY_Subkey_FileExts:
4501 subkey = file_extsW;
4502 size_subkey = sizeof(file_extsW);
4503 break;
4504 default:
4505 FIXME("unsupported flags (0x%08x)\n", flags);
4506 return NULL;
4509 if(sub_key)
4510 size_user = lstrlenW(sub_key)*sizeof(WCHAR);
4511 else
4512 size_user = 0;
4514 path = HeapAlloc(GetProcessHeap(), 0, size_key+size_subkey+size_user+sizeof(WCHAR));
4515 if(!path) {
4516 ERR("Out of memory\n");
4517 return NULL;
4520 memcpy(path, key, size_key);
4521 if(subkey)
4522 memcpy(path+size_key/sizeof(WCHAR), subkey, size_subkey);
4523 if(sub_key)
4524 memcpy(path+(size_key+size_subkey)/sizeof(WCHAR), sub_key, size_user);
4525 path[(size_key+size_subkey+size_user)/sizeof(WCHAR)] = '\0';
4527 if(create)
4528 RegCreateKeyExW((flags&0xf)==SHKEY_Root_HKLM?HKEY_LOCAL_MACHINE:HKEY_CURRENT_USER,
4529 path, 0, NULL, 0, MAXIMUM_ALLOWED, NULL, &hkey, NULL);
4530 else
4531 RegOpenKeyExW((flags&0xf)==SHKEY_Root_HKLM?HKEY_LOCAL_MACHINE:HKEY_CURRENT_USER,
4532 path, 0, MAXIMUM_ALLOWED, &hkey);
4534 HeapFree(GetProcessHeap(), 0, path);
4535 return hkey;
4538 /***********************************************************************
4539 * SHQueueUserWorkItem (SHLWAPI.@)
4541 BOOL WINAPI SHQueueUserWorkItem(LPTHREAD_START_ROUTINE pfnCallback,
4542 LPVOID pContext, LONG lPriority, DWORD_PTR dwTag,
4543 DWORD_PTR *pdwId, LPCSTR pszModule, DWORD dwFlags)
4545 TRACE("(%p, %p, %d, %lx, %p, %s, %08x)\n", pfnCallback, pContext,
4546 lPriority, dwTag, pdwId, debugstr_a(pszModule), dwFlags);
4548 if(lPriority || dwTag || pdwId || pszModule || dwFlags)
4549 FIXME("Unsupported arguments\n");
4551 return QueueUserWorkItem(pfnCallback, pContext, 0);
4554 /***********************************************************************
4555 * SHSetTimerQueueTimer (SHLWAPI.263)
4557 HANDLE WINAPI SHSetTimerQueueTimer(HANDLE hQueue,
4558 WAITORTIMERCALLBACK pfnCallback, LPVOID pContext, DWORD dwDueTime,
4559 DWORD dwPeriod, LPCSTR lpszLibrary, DWORD dwFlags)
4561 HANDLE hNewTimer;
4563 /* SHSetTimerQueueTimer flags -> CreateTimerQueueTimer flags */
4564 if (dwFlags & TPS_LONGEXECTIME) {
4565 dwFlags &= ~TPS_LONGEXECTIME;
4566 dwFlags |= WT_EXECUTELONGFUNCTION;
4568 if (dwFlags & TPS_EXECUTEIO) {
4569 dwFlags &= ~TPS_EXECUTEIO;
4570 dwFlags |= WT_EXECUTEINIOTHREAD;
4573 if (!CreateTimerQueueTimer(&hNewTimer, hQueue, pfnCallback, pContext,
4574 dwDueTime, dwPeriod, dwFlags))
4575 return NULL;
4577 return hNewTimer;
4580 /***********************************************************************
4581 * IUnknown_OnFocusChangeIS (SHLWAPI.@)
4583 HRESULT WINAPI IUnknown_OnFocusChangeIS(LPUNKNOWN lpUnknown, LPUNKNOWN pFocusObject, BOOL bFocus)
4585 IInputObjectSite *pIOS = NULL;
4586 HRESULT hRet = E_INVALIDARG;
4588 TRACE("(%p, %p, %s)\n", lpUnknown, pFocusObject, bFocus ? "TRUE" : "FALSE");
4590 if (lpUnknown)
4592 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObjectSite,
4593 (void **)&pIOS);
4594 if (SUCCEEDED(hRet) && pIOS)
4596 hRet = IInputObjectSite_OnFocusChangeIS(pIOS, pFocusObject, bFocus);
4597 IInputObjectSite_Release(pIOS);
4600 return hRet;
4603 /***********************************************************************
4604 * SKAllocValueW (SHLWAPI.519)
4606 HRESULT WINAPI SKAllocValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value, DWORD *type,
4607 LPVOID *data, DWORD *count)
4609 DWORD ret, size;
4610 HKEY hkey;
4612 TRACE("(0x%x, %s, %s, %p, %p, %p)\n", flags, debugstr_w(subkey),
4613 debugstr_w(value), type, data, count);
4615 hkey = SHGetShellKey(flags, subkey, FALSE);
4616 if (!hkey)
4617 return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4619 ret = SHQueryValueExW(hkey, value, NULL, type, NULL, &size);
4620 if (ret) {
4621 RegCloseKey(hkey);
4622 return HRESULT_FROM_WIN32(ret);
4625 size += 2;
4626 *data = LocalAlloc(0, size);
4627 if (!*data) {
4628 RegCloseKey(hkey);
4629 return E_OUTOFMEMORY;
4632 ret = SHQueryValueExW(hkey, value, NULL, type, *data, &size);
4633 if (count)
4634 *count = size;
4636 RegCloseKey(hkey);
4637 return HRESULT_FROM_WIN32(ret);
4640 /***********************************************************************
4641 * SKDeleteValueW (SHLWAPI.518)
4643 HRESULT WINAPI SKDeleteValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value)
4645 DWORD ret;
4646 HKEY hkey;
4648 TRACE("(0x%x, %s %s)\n", flags, debugstr_w(subkey), debugstr_w(value));
4650 hkey = SHGetShellKey(flags, subkey, FALSE);
4651 if (!hkey)
4652 return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4654 ret = RegDeleteValueW(hkey, value);
4656 RegCloseKey(hkey);
4657 return HRESULT_FROM_WIN32(ret);
4660 /***********************************************************************
4661 * SKGetValueW (SHLWAPI.516)
4663 HRESULT WINAPI SKGetValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value, DWORD *type,
4664 void *data, DWORD *count)
4666 DWORD ret;
4667 HKEY hkey;
4669 TRACE("(0x%x, %s, %s, %p, %p, %p)\n", flags, debugstr_w(subkey),
4670 debugstr_w(value), type, data, count);
4672 hkey = SHGetShellKey(flags, subkey, FALSE);
4673 if (!hkey)
4674 return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4676 ret = SHQueryValueExW(hkey, value, NULL, type, data, count);
4678 RegCloseKey(hkey);
4679 return HRESULT_FROM_WIN32(ret);
4682 /***********************************************************************
4683 * SKSetValueW (SHLWAPI.516)
4685 HRESULT WINAPI SKSetValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value,
4686 DWORD type, void *data, DWORD count)
4688 DWORD ret;
4689 HKEY hkey;
4691 TRACE("(0x%x, %s, %s, %x, %p, %d)\n", flags, debugstr_w(subkey),
4692 debugstr_w(value), type, data, count);
4694 hkey = SHGetShellKey(flags, subkey, TRUE);
4695 if (!hkey)
4696 return HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
4698 ret = RegSetValueExW(hkey, value, 0, type, data, count);
4700 RegCloseKey(hkey);
4701 return HRESULT_FROM_WIN32(ret);
4704 typedef HRESULT (WINAPI *DllGetVersion_func)(DLLVERSIONINFO *);
4706 /***********************************************************************
4707 * GetUIVersion (SHLWAPI.452)
4709 DWORD WINAPI GetUIVersion(void)
4711 static DWORD version;
4713 if (!version)
4715 DllGetVersion_func pDllGetVersion;
4716 HMODULE dll = LoadLibraryA("shell32.dll");
4717 if (!dll) return 0;
4719 pDllGetVersion = (DllGetVersion_func)GetProcAddress(dll, "DllGetVersion");
4720 if (pDllGetVersion)
4722 DLLVERSIONINFO dvi;
4723 dvi.cbSize = sizeof(DLLVERSIONINFO);
4724 if (pDllGetVersion(&dvi) == S_OK) version = dvi.dwMajorVersion;
4726 FreeLibrary( dll );
4727 if (!version) version = 3; /* old shell dlls don't have DllGetVersion */
4729 return version;
4732 /***********************************************************************
4733 * ShellMessageBoxWrapW [SHLWAPI.388]
4735 * See shell32.ShellMessageBoxW
4737 * NOTE:
4738 * shlwapi.ShellMessageBoxWrapW is a duplicate of shell32.ShellMessageBoxW
4739 * because we can't forward to it in the .spec file since it's exported by
4740 * ordinal. If you change the implementation here please update the code in
4741 * shell32 as well.
4743 INT WINAPIV ShellMessageBoxWrapW(HINSTANCE hInstance, HWND hWnd, LPCWSTR lpText,
4744 LPCWSTR lpCaption, UINT uType, ...)
4746 WCHAR *szText = NULL, szTitle[100];
4747 LPCWSTR pszText, pszTitle = szTitle;
4748 LPWSTR pszTemp;
4749 __ms_va_list args;
4750 int ret;
4752 __ms_va_start(args, uType);
4754 TRACE("(%p,%p,%p,%p,%08x)\n", hInstance, hWnd, lpText, lpCaption, uType);
4756 if (IS_INTRESOURCE(lpCaption))
4757 LoadStringW(hInstance, LOWORD(lpCaption), szTitle, sizeof(szTitle)/sizeof(szTitle[0]));
4758 else
4759 pszTitle = lpCaption;
4761 if (IS_INTRESOURCE(lpText))
4763 const WCHAR *ptr;
4764 UINT len = LoadStringW(hInstance, LOWORD(lpText), (LPWSTR)&ptr, 0);
4766 if (len)
4768 szText = HeapAlloc(GetProcessHeap(), 0, (len + 1) * sizeof(WCHAR));
4769 if (szText) LoadStringW(hInstance, LOWORD(lpText), szText, len + 1);
4771 pszText = szText;
4772 if (!pszText) {
4773 WARN("Failed to load id %d\n", LOWORD(lpText));
4774 __ms_va_end(args);
4775 return 0;
4778 else
4779 pszText = lpText;
4781 FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
4782 pszText, 0, 0, (LPWSTR)&pszTemp, 0, &args);
4784 __ms_va_end(args);
4786 ret = MessageBoxW(hWnd, pszTemp, pszTitle, uType);
4788 HeapFree(GetProcessHeap(), 0, szText);
4789 LocalFree(pszTemp);
4790 return ret;
4793 /***********************************************************************
4794 * ZoneComputePaneSize [SHLWAPI.382]
4796 UINT WINAPI ZoneComputePaneSize(HWND hwnd)
4798 FIXME("\n");
4799 return 0x95;
4802 /***********************************************************************
4803 * SHChangeNotifyWrap [SHLWAPI.394]
4805 void WINAPI SHChangeNotifyWrap(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2)
4807 SHChangeNotify(wEventId, uFlags, dwItem1, dwItem2);
4810 typedef struct SHELL_USER_SID { /* according to MSDN this should be in shlobj.h... */
4811 SID_IDENTIFIER_AUTHORITY sidAuthority;
4812 DWORD dwUserGroupID;
4813 DWORD dwUserID;
4814 } SHELL_USER_SID, *PSHELL_USER_SID;
4816 typedef struct SHELL_USER_PERMISSION { /* ...and this should be in shlwapi.h */
4817 SHELL_USER_SID susID;
4818 DWORD dwAccessType;
4819 BOOL fInherit;
4820 DWORD dwAccessMask;
4821 DWORD dwInheritMask;
4822 DWORD dwInheritAccessMask;
4823 } SHELL_USER_PERMISSION, *PSHELL_USER_PERMISSION;
4825 /***********************************************************************
4826 * GetShellSecurityDescriptor [SHLWAPI.475]
4828 * prepares SECURITY_DESCRIPTOR from a set of ACEs
4830 * PARAMS
4831 * apUserPerm [I] array of pointers to SHELL_USER_PERMISSION structures,
4832 * each of which describes permissions to apply
4833 * cUserPerm [I] number of entries in apUserPerm array
4835 * RETURNS
4836 * success: pointer to SECURITY_DESCRIPTOR
4837 * failure: NULL
4839 * NOTES
4840 * Call should free returned descriptor with LocalFree
4842 PSECURITY_DESCRIPTOR WINAPI GetShellSecurityDescriptor(PSHELL_USER_PERMISSION *apUserPerm, int cUserPerm)
4844 PSID *sidlist;
4845 PSID cur_user = NULL;
4846 BYTE tuUser[2000];
4847 DWORD acl_size;
4848 int sid_count, i;
4849 PSECURITY_DESCRIPTOR psd = NULL;
4851 TRACE("%p %d\n", apUserPerm, cUserPerm);
4853 if (apUserPerm == NULL || cUserPerm <= 0)
4854 return NULL;
4856 sidlist = HeapAlloc(GetProcessHeap(), 0, cUserPerm * sizeof(PSID));
4857 if (!sidlist)
4858 return NULL;
4860 acl_size = sizeof(ACL);
4862 for(sid_count = 0; sid_count < cUserPerm; sid_count++)
4864 static SHELL_USER_SID null_sid = {{SECURITY_NULL_SID_AUTHORITY}, 0, 0};
4865 PSHELL_USER_PERMISSION perm = apUserPerm[sid_count];
4866 PSHELL_USER_SID sid = &perm->susID;
4867 PSID pSid;
4868 BOOL ret = TRUE;
4870 if (!memcmp((void*)sid, (void*)&null_sid, sizeof(SHELL_USER_SID)))
4871 { /* current user's SID */
4872 if (!cur_user)
4874 HANDLE Token;
4875 DWORD bufsize = sizeof(tuUser);
4877 ret = OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY, &Token);
4878 if (ret)
4880 ret = GetTokenInformation(Token, TokenUser, (void*)tuUser, bufsize, &bufsize );
4881 if (ret)
4882 cur_user = ((PTOKEN_USER)tuUser)->User.Sid;
4883 CloseHandle(Token);
4886 pSid = cur_user;
4887 } else if (sid->dwUserID==0) /* one sub-authority */
4888 ret = AllocateAndInitializeSid(&sid->sidAuthority, 1, sid->dwUserGroupID, 0,
4889 0, 0, 0, 0, 0, 0, &pSid);
4890 else
4891 ret = AllocateAndInitializeSid(&sid->sidAuthority, 2, sid->dwUserGroupID, sid->dwUserID,
4892 0, 0, 0, 0, 0, 0, &pSid);
4893 if (!ret)
4894 goto free_sids;
4896 sidlist[sid_count] = pSid;
4897 /* increment acl_size (1 ACE for non-inheritable and 2 ACEs for inheritable records */
4898 acl_size += (sizeof(ACCESS_ALLOWED_ACE)-sizeof(DWORD) + GetLengthSid(pSid)) * (perm->fInherit ? 2 : 1);
4901 psd = LocalAlloc(0, sizeof(SECURITY_DESCRIPTOR) + acl_size);
4903 if (psd != NULL)
4905 PACL pAcl = (PACL)(((BYTE*)psd)+sizeof(SECURITY_DESCRIPTOR));
4907 if (!InitializeSecurityDescriptor(psd, SECURITY_DESCRIPTOR_REVISION))
4908 goto error;
4910 if (!InitializeAcl(pAcl, acl_size, ACL_REVISION))
4911 goto error;
4913 for(i = 0; i < sid_count; i++)
4915 PSHELL_USER_PERMISSION sup = apUserPerm[i];
4916 PSID sid = sidlist[i];
4918 switch(sup->dwAccessType)
4920 case ACCESS_ALLOWED_ACE_TYPE:
4921 if (!AddAccessAllowedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4922 goto error;
4923 if (sup->fInherit && !AddAccessAllowedAceEx(pAcl, ACL_REVISION,
4924 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4925 goto error;
4926 break;
4927 case ACCESS_DENIED_ACE_TYPE:
4928 if (!AddAccessDeniedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4929 goto error;
4930 if (sup->fInherit && !AddAccessDeniedAceEx(pAcl, ACL_REVISION,
4931 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4932 goto error;
4933 break;
4934 default:
4935 goto error;
4939 if (!SetSecurityDescriptorDacl(psd, TRUE, pAcl, FALSE))
4940 goto error;
4942 goto free_sids;
4944 error:
4945 LocalFree(psd);
4946 psd = NULL;
4947 free_sids:
4948 for(i = 0; i < sid_count; i++)
4950 if (!cur_user || sidlist[i] != cur_user)
4951 FreeSid(sidlist[i]);
4953 HeapFree(GetProcessHeap(), 0, sidlist);
4955 return psd;
4958 /***********************************************************************
4959 * SHCreatePropertyBagOnRegKey [SHLWAPI.471]
4961 * Creates a property bag from a registry key
4963 * PARAMS
4964 * hKey [I] Handle to the desired registry key
4965 * subkey [I] Name of desired subkey, or NULL to open hKey directly
4966 * grfMode [I] Optional flags
4967 * riid [I] IID of requested property bag interface
4968 * ppv [O] Address to receive pointer to the new interface
4970 * RETURNS
4971 * success: 0
4972 * failure: error code
4975 HRESULT WINAPI SHCreatePropertyBagOnRegKey (HKEY hKey, LPCWSTR subkey,
4976 DWORD grfMode, REFIID riid, void **ppv)
4978 FIXME("%p %s %d %s %p STUB\n", hKey, debugstr_w(subkey), grfMode,
4979 debugstr_guid(riid), ppv);
4981 return E_NOTIMPL;
4984 /***********************************************************************
4985 * SHGetViewStatePropertyBag [SHLWAPI.515]
4987 * Retrieves a property bag in which the view state information of a folder
4988 * can be stored.
4990 * PARAMS
4991 * pidl [I] PIDL of the folder requested
4992 * bag_name [I] Name of the property bag requested
4993 * flags [I] Optional flags
4994 * riid [I] IID of requested property bag interface
4995 * ppv [O] Address to receive pointer to the new interface
4997 * RETURNS
4998 * success: S_OK
4999 * failure: error code
5002 HRESULT WINAPI SHGetViewStatePropertyBag(LPCITEMIDLIST pidl, LPWSTR bag_name,
5003 DWORD flags, REFIID riid, void **ppv)
5005 FIXME("%p %s %d %s %p STUB\n", pidl, debugstr_w(bag_name), flags,
5006 debugstr_guid(riid), ppv);
5008 return E_NOTIMPL;
5011 /***********************************************************************
5012 * SHFormatDateTimeW [SHLWAPI.354]
5014 * Produces a string representation of a time.
5016 * PARAMS
5017 * fileTime [I] Pointer to FILETIME structure specifying the time
5018 * flags [I] Flags specifying the desired output
5019 * buf [O] Pointer to buffer for output
5020 * size [I] Number of characters that can be contained in buffer
5022 * RETURNS
5023 * success: number of characters written to the buffer
5024 * failure: 0
5027 INT WINAPI SHFormatDateTimeW(const FILETIME UNALIGNED *fileTime, DWORD *flags,
5028 LPWSTR buf, UINT size)
5030 #define SHFORMATDT_UNSUPPORTED_FLAGS (FDTF_RELATIVE | FDTF_LTRDATE | FDTF_RTLDATE | FDTF_NOAUTOREADINGORDER)
5031 DWORD fmt_flags = flags ? *flags : FDTF_DEFAULT;
5032 SYSTEMTIME st;
5033 FILETIME ft;
5034 INT ret = 0;
5036 TRACE("%p %p %p %u\n", fileTime, flags, buf, size);
5038 if (!buf || !size)
5039 return 0;
5041 if (fmt_flags & SHFORMATDT_UNSUPPORTED_FLAGS)
5042 FIXME("ignoring some flags - 0x%08x\n", fmt_flags & SHFORMATDT_UNSUPPORTED_FLAGS);
5044 FileTimeToLocalFileTime(fileTime, &ft);
5045 FileTimeToSystemTime(&ft, &st);
5047 /* first of all date */
5048 if (fmt_flags & (FDTF_LONGDATE | FDTF_SHORTDATE))
5050 static const WCHAR sep1[] = {',',' ',0};
5051 static const WCHAR sep2[] = {' ',0};
5053 DWORD date = fmt_flags & FDTF_LONGDATE ? DATE_LONGDATE : DATE_SHORTDATE;
5054 ret = GetDateFormatW(LOCALE_USER_DEFAULT, date, &st, NULL, buf, size);
5055 if (ret >= size) return ret;
5057 /* add separator */
5058 if (ret < size && (fmt_flags & (FDTF_LONGTIME | FDTF_SHORTTIME)))
5060 if ((fmt_flags & FDTF_LONGDATE) && (ret < size + 2))
5062 lstrcatW(&buf[ret-1], sep1);
5063 ret += 2;
5065 else
5067 lstrcatW(&buf[ret-1], sep2);
5068 ret++;
5072 /* time part */
5073 if (fmt_flags & (FDTF_LONGTIME | FDTF_SHORTTIME))
5075 DWORD time = fmt_flags & FDTF_LONGTIME ? 0 : TIME_NOSECONDS;
5077 if (ret) ret--;
5078 ret += GetTimeFormatW(LOCALE_USER_DEFAULT, time, &st, NULL, &buf[ret], size - ret);
5081 return ret;
5083 #undef SHFORMATDT_UNSUPPORTED_FLAGS
5086 /***********************************************************************
5087 * SHFormatDateTimeA [SHLWAPI.353]
5089 * See SHFormatDateTimeW.
5092 INT WINAPI SHFormatDateTimeA(const FILETIME UNALIGNED *fileTime, DWORD *flags,
5093 LPSTR buf, UINT size)
5095 WCHAR *bufW;
5096 INT retval;
5098 if (!buf || !size)
5099 return 0;
5101 bufW = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * size);
5102 retval = SHFormatDateTimeW(fileTime, flags, bufW, size);
5104 if (retval != 0)
5105 WideCharToMultiByte(CP_ACP, 0, bufW, -1, buf, size, NULL, NULL);
5107 HeapFree(GetProcessHeap(), 0, bufW);
5108 return retval;
5111 /***********************************************************************
5112 * ZoneCheckUrlExW [SHLWAPI.231]
5114 * Checks the details of the security zone for the supplied site. (?)
5116 * PARAMS
5118 * szURL [I] Pointer to the URL to check
5120 * Other parameters currently unknown.
5122 * RETURNS
5123 * unknown
5126 INT WINAPI ZoneCheckUrlExW(LPWSTR szURL, PVOID pUnknown, DWORD dwUnknown2,
5127 DWORD dwUnknown3, DWORD dwUnknown4, DWORD dwUnknown5, DWORD dwUnknown6,
5128 DWORD dwUnknown7)
5130 FIXME("(%s,%p,%x,%x,%x,%x,%x,%x) STUB\n", debugstr_w(szURL), pUnknown, dwUnknown2,
5131 dwUnknown3, dwUnknown4, dwUnknown5, dwUnknown6, dwUnknown7);
5133 return 0;
5136 /***********************************************************************
5137 * SHVerbExistsNA [SHLWAPI.196]
5140 * PARAMS
5142 * verb [I] a string, often appears to be an extension.
5144 * Other parameters currently unknown.
5146 * RETURNS
5147 * unknown
5149 INT WINAPI SHVerbExistsNA(LPSTR verb, PVOID pUnknown, PVOID pUnknown2, DWORD dwUnknown3)
5151 FIXME("(%s, %p, %p, %i) STUB\n",verb, pUnknown, pUnknown2, dwUnknown3);
5152 return 0;
5155 /*************************************************************************
5156 * @ [SHLWAPI.538]
5158 * Undocumented: Implementation guessed at via Name and behavior
5160 * PARAMS
5161 * lpUnknown [I] Object to get an IServiceProvider interface from
5162 * riid [I] Function requested for QueryService call
5163 * lppOut [O] Destination for the service interface pointer
5165 * RETURNS
5166 * Success: S_OK. lppOut contains an object providing the requested service
5167 * Failure: An HRESULT error code
5169 * NOTES
5170 * lpUnknown is expected to support the IServiceProvider interface.
5172 HRESULT WINAPI IUnknown_QueryServiceForWebBrowserApp(IUnknown* lpUnknown,
5173 REFGUID riid, LPVOID *lppOut)
5175 FIXME("%p %s %p semi-STUB\n", lpUnknown, debugstr_guid(riid), lppOut);
5176 return IUnknown_QueryService(lpUnknown,&IID_IWebBrowserApp,riid,lppOut);
5179 /**************************************************************************
5180 * SHPropertyBag_ReadLONG (SHLWAPI.496)
5182 * This function asks a property bag to read a named property as a LONG.
5184 * PARAMS
5185 * ppb: a IPropertyBag interface
5186 * pszPropName: Unicode string that names the property
5187 * pValue: address to receive the property value as a 32-bit signed integer
5189 * RETURNS
5190 * HRESULT codes
5192 HRESULT WINAPI SHPropertyBag_ReadLONG(IPropertyBag *ppb, LPCWSTR pszPropName, LPLONG pValue)
5194 VARIANT var;
5195 HRESULT hr;
5196 TRACE("%p %s %p\n", ppb,debugstr_w(pszPropName),pValue);
5197 if (!pszPropName || !ppb || !pValue)
5198 return E_INVALIDARG;
5199 V_VT(&var) = VT_I4;
5200 hr = IPropertyBag_Read(ppb, pszPropName, &var, NULL);
5201 if (SUCCEEDED(hr))
5203 if (V_VT(&var) == VT_I4)
5204 *pValue = V_I4(&var);
5205 else
5206 hr = DISP_E_BADVARTYPE;
5208 return hr;
5211 /* return flags for SHGetObjectCompatFlags, names derived from registry value names */
5212 #define OBJCOMPAT_OTNEEDSSFCACHE 0x00000001
5213 #define OBJCOMPAT_NO_WEBVIEW 0x00000002
5214 #define OBJCOMPAT_UNBINDABLE 0x00000004
5215 #define OBJCOMPAT_PINDLL 0x00000008
5216 #define OBJCOMPAT_NEEDSFILESYSANCESTOR 0x00000010
5217 #define OBJCOMPAT_NOTAFILESYSTEM 0x00000020
5218 #define OBJCOMPAT_CTXMENU_NOVERBS 0x00000040
5219 #define OBJCOMPAT_CTXMENU_LIMITEDQI 0x00000080
5220 #define OBJCOMPAT_COCREATESHELLFOLDERONLY 0x00000100
5221 #define OBJCOMPAT_NEEDSSTORAGEANCESTOR 0x00000200
5222 #define OBJCOMPAT_NOLEGACYWEBVIEW 0x00000400
5223 #define OBJCOMPAT_CTXMENU_XPQCMFLAGS 0x00001000
5224 #define OBJCOMPAT_NOIPROPERTYSTORE 0x00002000
5226 /* a search table for compatibility flags */
5227 struct objcompat_entry {
5228 const WCHAR name[30];
5229 DWORD value;
5232 /* expected to be sorted by name */
5233 static const struct objcompat_entry objcompat_table[] = {
5234 { {'C','O','C','R','E','A','T','E','S','H','E','L','L','F','O','L','D','E','R','O','N','L','Y',0},
5235 OBJCOMPAT_COCREATESHELLFOLDERONLY },
5236 { {'C','T','X','M','E','N','U','_','L','I','M','I','T','E','D','Q','I',0},
5237 OBJCOMPAT_CTXMENU_LIMITEDQI },
5238 { {'C','T','X','M','E','N','U','_','N','O','V','E','R','B','S',0},
5239 OBJCOMPAT_CTXMENU_LIMITEDQI },
5240 { {'C','T','X','M','E','N','U','_','X','P','Q','C','M','F','L','A','G','S',0},
5241 OBJCOMPAT_CTXMENU_XPQCMFLAGS },
5242 { {'N','E','E','D','S','F','I','L','E','S','Y','S','A','N','C','E','S','T','O','R',0},
5243 OBJCOMPAT_NEEDSFILESYSANCESTOR },
5244 { {'N','E','E','D','S','S','T','O','R','A','G','E','A','N','C','E','S','T','O','R',0},
5245 OBJCOMPAT_NEEDSSTORAGEANCESTOR },
5246 { {'N','O','I','P','R','O','P','E','R','T','Y','S','T','O','R','E',0},
5247 OBJCOMPAT_NOIPROPERTYSTORE },
5248 { {'N','O','L','E','G','A','C','Y','W','E','B','V','I','E','W',0},
5249 OBJCOMPAT_NOLEGACYWEBVIEW },
5250 { {'N','O','T','A','F','I','L','E','S','Y','S','T','E','M',0},
5251 OBJCOMPAT_NOTAFILESYSTEM },
5252 { {'N','O','_','W','E','B','V','I','E','W',0},
5253 OBJCOMPAT_NO_WEBVIEW },
5254 { {'O','T','N','E','E','D','S','S','F','C','A','C','H','E',0},
5255 OBJCOMPAT_OTNEEDSSFCACHE },
5256 { {'P','I','N','D','L','L',0},
5257 OBJCOMPAT_PINDLL },
5258 { {'U','N','B','I','N','D','A','B','L','E',0},
5259 OBJCOMPAT_UNBINDABLE }
5262 /**************************************************************************
5263 * SHGetObjectCompatFlags (SHLWAPI.476)
5265 * Function returns an integer representation of compatibility flags stored
5266 * in registry for CLSID under ShellCompatibility subkey.
5268 * PARAMS
5269 * pUnk: pointer to object IUnknown interface, idetifies CLSID
5270 * clsid: pointer to CLSID to retrieve data for
5272 * RETURNS
5273 * 0 on failure, flags set on success
5275 DWORD WINAPI SHGetObjectCompatFlags(IUnknown *pUnk, const CLSID *clsid)
5277 static const WCHAR compatpathW[] =
5278 {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o','s','o','f','t','\\',
5279 'W','i','n','d','o','w','s','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\',
5280 'S','h','e','l','l','C','o','m','p','a','t','i','b','i','l','i','t','y','\\',
5281 'O','b','j','e','c','t','s','\\','%','s',0};
5282 WCHAR strW[sizeof(compatpathW)/sizeof(WCHAR) + 38 /* { CLSID } */];
5283 DWORD ret, length = sizeof(strW)/sizeof(WCHAR);
5284 OLECHAR *clsid_str;
5285 HKEY key;
5286 INT i;
5288 TRACE("%p %s\n", pUnk, debugstr_guid(clsid));
5290 if (!pUnk && !clsid) return 0;
5292 if (pUnk && !clsid)
5294 FIXME("iface not handled\n");
5295 return 0;
5298 StringFromCLSID(clsid, &clsid_str);
5299 sprintfW(strW, compatpathW, clsid_str);
5300 CoTaskMemFree(clsid_str);
5302 ret = RegOpenKeyW(HKEY_LOCAL_MACHINE, strW, &key);
5303 if (ret != ERROR_SUCCESS) return 0;
5305 /* now collect flag values */
5306 ret = 0;
5307 for (i = 0; RegEnumValueW(key, i, strW, &length, NULL, NULL, NULL, NULL) == ERROR_SUCCESS; i++)
5309 INT left, right, res, x;
5311 /* search in table */
5312 left = 0;
5313 right = sizeof(objcompat_table) / sizeof(struct objcompat_entry) - 1;
5315 while (right >= left) {
5316 x = (left + right) / 2;
5317 res = strcmpW(strW, objcompat_table[x].name);
5318 if (res == 0)
5320 ret |= objcompat_table[x].value;
5321 break;
5323 else if (res < 0)
5324 right = x - 1;
5325 else
5326 left = x + 1;
5329 length = sizeof(strW)/sizeof(WCHAR);
5332 return ret;