msi: Adjust the signedness of three variables.
[wine/wine64.git] / dlls / shlwapi / ordinal.c
blob6aca53d535fcefd6fe4c5e6b920fcded1ddac67d
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
31 #define NONAMELESSUNION
32 #define NONAMELESSSTRUCT
34 #include "windef.h"
35 #include "winbase.h"
36 #include "winnls.h"
37 #include "winreg.h"
38 #include "wingdi.h"
39 #include "winuser.h"
40 #include "winver.h"
41 #include "winnetwk.h"
42 #include "mmsystem.h"
43 #include "objbase.h"
44 #include "exdisp.h"
45 #include "shlobj.h"
46 #include "shlwapi.h"
47 #include "shellapi.h"
48 #include "commdlg.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,BOOL);
62 BOOL WINAPI SHAboutInfoW(LPWSTR,DWORD);
65 NOTES: Most functions exported by ordinal seem to be superflous.
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_DupSharedHandle
77 * Internal implemetation of SHLWAPI_11.
79 static
80 HANDLE WINAPI SHLWAPI_DupSharedHandle(HANDLE hShared, DWORD dwDstProcId,
81 DWORD dwSrcProcId, DWORD dwAccess,
82 DWORD dwOptions)
84 HANDLE hDst, hSrc;
85 DWORD dwMyProcId = GetCurrentProcessId();
86 HANDLE hRet = NULL;
88 TRACE("(%p,%d,%d,%08x,%08x)\n", hShared, dwDstProcId, dwSrcProcId,
89 dwAccess, dwOptions);
91 /* Get dest process handle */
92 if (dwDstProcId == dwMyProcId)
93 hDst = GetCurrentProcess();
94 else
95 hDst = OpenProcess(PROCESS_DUP_HANDLE, 0, dwDstProcId);
97 if (hDst)
99 /* Get src process handle */
100 if (dwSrcProcId == dwMyProcId)
101 hSrc = GetCurrentProcess();
102 else
103 hSrc = OpenProcess(PROCESS_DUP_HANDLE, 0, dwSrcProcId);
105 if (hSrc)
107 /* Make handle available to dest process */
108 if (!DuplicateHandle(hDst, hShared, hSrc, &hRet,
109 dwAccess, 0, dwOptions | DUPLICATE_SAME_ACCESS))
110 hRet = NULL;
112 if (dwSrcProcId != dwMyProcId)
113 CloseHandle(hSrc);
116 if (dwDstProcId != dwMyProcId)
117 CloseHandle(hDst);
120 TRACE("Returning handle %p\n", hRet);
121 return hRet;
124 /*************************************************************************
125 * @ [SHLWAPI.7]
127 * Create a block of sharable memory and initialise it with data.
129 * PARAMS
130 * lpvData [I] Pointer to data to write
131 * dwSize [I] Size of data
132 * dwProcId [I] ID of process owning data
134 * RETURNS
135 * Success: A shared memory handle
136 * Failure: NULL
138 * NOTES
139 * Ordinals 7-11 provide a set of calls to create shared memory between a
140 * group of processes. The shared memory is treated opaquely in that its size
141 * is not exposed to clients who map it. This is accomplished by storing
142 * the size of the map as the first DWORD of mapped data, and then offsetting
143 * the view pointer returned by this size.
146 HANDLE WINAPI SHAllocShared(LPCVOID lpvData, DWORD dwSize, DWORD dwProcId)
148 HANDLE hMap;
149 LPVOID pMapped;
150 HANDLE hRet = NULL;
152 TRACE("(%p,%d,%d)\n", lpvData, dwSize, dwProcId);
154 /* Create file mapping of the correct length */
155 hMap = CreateFileMappingA(INVALID_HANDLE_VALUE, NULL, FILE_MAP_READ, 0,
156 dwSize + sizeof(dwSize), NULL);
157 if (!hMap)
158 return hRet;
160 /* Get a view in our process address space */
161 pMapped = MapViewOfFile(hMap, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
163 if (pMapped)
165 /* Write size of data, followed by the data, to the view */
166 *((DWORD*)pMapped) = dwSize;
167 if (lpvData)
168 memcpy((char *) pMapped + sizeof(dwSize), lpvData, dwSize);
170 /* Release view. All further views mapped will be opaque */
171 UnmapViewOfFile(pMapped);
172 hRet = SHLWAPI_DupSharedHandle(hMap, dwProcId,
173 GetCurrentProcessId(), FILE_MAP_ALL_ACCESS,
174 DUPLICATE_SAME_ACCESS);
177 CloseHandle(hMap);
178 return hRet;
181 /*************************************************************************
182 * @ [SHLWAPI.8]
184 * Get a pointer to a block of shared memory from a shared memory handle.
186 * PARAMS
187 * hShared [I] Shared memory handle
188 * dwProcId [I] ID of process owning hShared
190 * RETURNS
191 * Success: A pointer to the shared memory
192 * Failure: NULL
195 PVOID WINAPI SHLockShared(HANDLE hShared, DWORD dwProcId)
197 HANDLE hDup;
198 LPVOID pMapped;
200 TRACE("(%p %d)\n", hShared, dwProcId);
202 /* Get handle to shared memory for current process */
203 hDup = SHLWAPI_DupSharedHandle(hShared, dwProcId, GetCurrentProcessId(),
204 FILE_MAP_ALL_ACCESS, 0);
205 /* Get View */
206 pMapped = MapViewOfFile(hDup, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
207 CloseHandle(hDup);
209 if (pMapped)
210 return (char *) pMapped + sizeof(DWORD); /* Hide size */
211 return NULL;
214 /*************************************************************************
215 * @ [SHLWAPI.9]
217 * Release a pointer to a block of shared memory.
219 * PARAMS
220 * lpView [I] Shared memory pointer
222 * RETURNS
223 * Success: TRUE
224 * Failure: FALSE
227 BOOL WINAPI SHUnlockShared(LPVOID lpView)
229 TRACE("(%p)\n", lpView);
230 return UnmapViewOfFile((char *) lpView - sizeof(DWORD)); /* Include size */
233 /*************************************************************************
234 * @ [SHLWAPI.10]
236 * Destroy a block of sharable memory.
238 * PARAMS
239 * hShared [I] Shared memory handle
240 * dwProcId [I] ID of process owning hShared
242 * RETURNS
243 * Success: TRUE
244 * Failure: FALSE
247 BOOL WINAPI SHFreeShared(HANDLE hShared, DWORD dwProcId)
249 HANDLE hClose;
251 TRACE("(%p %d)\n", hShared, dwProcId);
253 /* Get a copy of the handle for our process, closing the source handle */
254 hClose = SHLWAPI_DupSharedHandle(hShared, dwProcId, GetCurrentProcessId(),
255 FILE_MAP_ALL_ACCESS,DUPLICATE_CLOSE_SOURCE);
256 /* Close local copy */
257 return CloseHandle(hClose);
260 /*************************************************************************
261 * @ [SHLWAPI.11]
263 * Copy a sharable memory handle from one process to another.
265 * PARAMS
266 * hShared [I] Shared memory handle to duplicate
267 * dwDstProcId [I] ID of the process wanting the duplicated handle
268 * dwSrcProcId [I] ID of the process owning hShared
269 * dwAccess [I] Desired DuplicateHandle() access
270 * dwOptions [I] Desired DuplicateHandle() options
272 * RETURNS
273 * Success: A handle suitable for use by the dwDstProcId process.
274 * Failure: A NULL handle.
277 HANDLE WINAPI SHMapHandle(HANDLE hShared, DWORD dwDstProcId, DWORD dwSrcProcId,
278 DWORD dwAccess, DWORD dwOptions)
280 HANDLE hRet;
282 hRet = SHLWAPI_DupSharedHandle(hShared, dwDstProcId, dwSrcProcId,
283 dwAccess, dwOptions);
284 return hRet;
287 /*************************************************************************
288 * @ [SHLWAPI.13]
290 * Create and register a clipboard enumerator for a web browser.
292 * PARAMS
293 * lpBC [I] Binding context
294 * lpUnknown [I] An object exposing the IWebBrowserApp interface
296 * RETURNS
297 * Success: S_OK.
298 * Failure: An HRESULT error code.
300 * NOTES
301 * The enumerator is stored as a property of the web browser. If it does not
302 * yet exist, it is created and set before being registered.
304 HRESULT WINAPI RegisterDefaultAcceptHeaders(LPBC lpBC, IUnknown *lpUnknown)
306 static const WCHAR szProperty[] = { '{','D','0','F','C','A','4','2','0',
307 '-','D','3','F','5','-','1','1','C','F', '-','B','2','1','1','-','0',
308 '0','A','A','0','0','4','A','E','8','3','7','}','\0' };
309 BSTR property;
310 IEnumFORMATETC* pIEnumFormatEtc = NULL;
311 VARIANTARG var;
312 HRESULT hRet;
313 IWebBrowserApp* pBrowser = NULL;
315 TRACE("(%p, %p)\n", lpBC, lpUnknown);
317 /* Get An IWebBrowserApp interface from lpUnknown */
318 hRet = IUnknown_QueryService(lpUnknown, &IID_IWebBrowserApp, &IID_IWebBrowserApp, (PVOID)&pBrowser);
319 if (FAILED(hRet) || !pBrowser)
320 return E_NOINTERFACE;
322 V_VT(&var) = VT_EMPTY;
324 /* The property we get is the browsers clipboard enumerator */
325 property = SysAllocString(szProperty);
326 hRet = IWebBrowserApp_GetProperty(pBrowser, property, &var);
327 SysFreeString(property);
328 if (FAILED(hRet))
329 return hRet;
331 if (V_VT(&var) == VT_EMPTY)
333 /* Iterate through accepted documents and RegisterClipBoardFormatA() them */
334 char szKeyBuff[128], szValueBuff[128];
335 DWORD dwKeySize, dwValueSize, dwRet = 0, dwCount = 0, dwNumValues, dwType;
336 FORMATETC* formatList, *format;
337 HKEY hDocs;
339 TRACE("Registering formats and creating IEnumFORMATETC instance\n");
341 if (!RegOpenKeyA(HKEY_LOCAL_MACHINE, "Software\\Microsoft\\Windows\\Current"
342 "Version\\Internet Settings\\Accepted Documents", &hDocs))
343 return E_FAIL;
345 /* Get count of values in key */
346 while (!dwRet)
348 dwKeySize = sizeof(szKeyBuff);
349 dwRet = RegEnumValueA(hDocs,dwCount,szKeyBuff,&dwKeySize,0,&dwType,0,0);
350 dwCount++;
353 dwNumValues = dwCount;
355 /* Note: dwCount = number of items + 1; The extra item is the end node */
356 format = formatList = HeapAlloc(GetProcessHeap(), 0, dwCount * sizeof(FORMATETC));
357 if (!formatList)
358 return E_OUTOFMEMORY;
360 if (dwNumValues > 1)
362 dwRet = 0;
363 dwCount = 0;
365 dwNumValues--;
367 /* Register clipboard formats for the values and populate format list */
368 while(!dwRet && dwCount < dwNumValues)
370 dwKeySize = sizeof(szKeyBuff);
371 dwValueSize = sizeof(szValueBuff);
372 dwRet = RegEnumValueA(hDocs, dwCount, szKeyBuff, &dwKeySize, 0, &dwType,
373 (PBYTE)szValueBuff, &dwValueSize);
374 if (!dwRet)
375 return E_FAIL;
377 format->cfFormat = RegisterClipboardFormatA(szValueBuff);
378 format->ptd = NULL;
379 format->dwAspect = 1;
380 format->lindex = 4;
381 format->tymed = -1;
383 format++;
384 dwCount++;
388 /* Terminate the (maybe empty) list, last entry has a cfFormat of 0 */
389 format->cfFormat = 0;
390 format->ptd = NULL;
391 format->dwAspect = 1;
392 format->lindex = 4;
393 format->tymed = -1;
395 /* Create a clipboard enumerator */
396 hRet = CreateFormatEnumerator(dwNumValues, formatList, &pIEnumFormatEtc);
398 if (FAILED(hRet) || !pIEnumFormatEtc)
399 return hRet;
401 /* Set our enumerator as the browsers property */
402 V_VT(&var) = VT_UNKNOWN;
403 V_UNKNOWN(&var) = (IUnknown*)pIEnumFormatEtc;
405 hRet = IWebBrowserApp_PutProperty(pBrowser, (BSTR)szProperty, var);
406 if (FAILED(hRet))
408 IEnumFORMATETC_Release(pIEnumFormatEtc);
409 goto RegisterDefaultAcceptHeaders_Exit;
413 if (V_VT(&var) == VT_UNKNOWN)
415 /* Our variant is holding the clipboard enumerator */
416 IUnknown* pIUnknown = V_UNKNOWN(&var);
417 IEnumFORMATETC* pClone = NULL;
419 TRACE("Retrieved IEnumFORMATETC property\n");
421 /* Get an IEnumFormatEtc interface from the variants value */
422 pIEnumFormatEtc = NULL;
423 hRet = IUnknown_QueryInterface(pIUnknown, &IID_IEnumFORMATETC,
424 (PVOID)&pIEnumFormatEtc);
425 if (!hRet && pIEnumFormatEtc)
427 /* Clone and register the enumerator */
428 hRet = IEnumFORMATETC_Clone(pIEnumFormatEtc, &pClone);
429 if (!hRet && pClone)
431 RegisterFormatEnumerator(lpBC, pClone, 0);
433 IEnumFORMATETC_Release(pClone);
436 /* Release the IEnumFormatEtc interface */
437 IEnumFORMATETC_Release(pIUnknown);
439 IUnknown_Release(V_UNKNOWN(&var));
442 RegisterDefaultAcceptHeaders_Exit:
443 IWebBrowserApp_Release(pBrowser);
444 return hRet;
447 /*************************************************************************
448 * @ [SHLWAPI.15]
450 * Get Explorers "AcceptLanguage" setting.
452 * PARAMS
453 * langbuf [O] Destination for language string
454 * buflen [I] Length of langbuf
455 * [0] Success: used length of langbuf
457 * RETURNS
458 * Success: S_OK. langbuf is set to the language string found.
459 * Failure: E_FAIL, If any arguments are invalid, error occurred, or Explorer
460 * does not contain the setting.
461 * E_INVALIDARG, If the buffer is not big enough
463 HRESULT WINAPI GetAcceptLanguagesW( LPWSTR langbuf, LPDWORD buflen)
465 static const WCHAR szkeyW[] = {
466 'S','o','f','t','w','a','r','e','\\',
467 'M','i','c','r','o','s','o','f','t','\\',
468 'I','n','t','e','r','n','e','t',' ','E','x','p','l','o','r','e','r','\\',
469 'I','n','t','e','r','n','a','t','i','o','n','a','l',0};
470 static const WCHAR valueW[] = {
471 'A','c','c','e','p','t','L','a','n','g','u','a','g','e',0};
472 static const WCHAR enusW[] = {'e','n','-','u','s',0};
473 DWORD mystrlen, mytype;
474 HKEY mykey;
475 HRESULT retval;
476 LCID mylcid;
477 WCHAR *mystr;
479 if(!langbuf || !buflen || !*buflen)
480 return E_FAIL;
482 mystrlen = (*buflen > 20) ? *buflen : 20 ;
483 mystr = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * mystrlen);
484 RegOpenKeyW(HKEY_CURRENT_USER, szkeyW, &mykey);
485 if(RegQueryValueExW(mykey, valueW, 0, &mytype, (PBYTE)mystr, &mystrlen)) {
486 /* Did not find value */
487 mylcid = GetUserDefaultLCID();
488 /* somehow the mylcid translates into "en-us"
489 * this is similar to "LOCALE_SABBREVLANGNAME"
490 * which could be gotten via GetLocaleInfo.
491 * The only problem is LOCALE_SABBREVLANGUAGE" is
492 * a 3 char string (first 2 are country code and third is
493 * letter for "sublanguage", which does not come close to
494 * "en-us"
496 lstrcpyW(mystr, enusW);
497 mystrlen = lstrlenW(mystr);
498 } else {
499 /* handle returned string */
500 FIXME("missing code\n");
502 memcpy( langbuf, mystr, min(*buflen,strlenW(mystr)+1)*sizeof(WCHAR) );
504 if(*buflen > strlenW(mystr)) {
505 *buflen = strlenW(mystr);
506 retval = S_OK;
507 } else {
508 *buflen = 0;
509 retval = E_INVALIDARG;
510 SetLastError(ERROR_INSUFFICIENT_BUFFER);
512 RegCloseKey(mykey);
513 HeapFree(GetProcessHeap(), 0, mystr);
514 return retval;
517 /*************************************************************************
518 * @ [SHLWAPI.14]
520 * Ascii version of GetAcceptLanguagesW.
522 HRESULT WINAPI GetAcceptLanguagesA( LPSTR langbuf, LPDWORD buflen)
524 WCHAR *langbufW;
525 DWORD buflenW, convlen;
526 HRESULT retval;
528 if(!langbuf || !buflen || !*buflen) return E_FAIL;
530 buflenW = *buflen;
531 langbufW = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * buflenW);
532 retval = GetAcceptLanguagesW(langbufW, &buflenW);
534 if (retval == S_OK)
536 convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, -1, langbuf, *buflen, NULL, NULL);
538 else /* copy partial string anyway */
540 convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, *buflen, langbuf, *buflen, NULL, NULL);
541 if (convlen < *buflen) langbuf[convlen] = 0;
543 *buflen = buflenW ? convlen : 0;
545 HeapFree(GetProcessHeap(), 0, langbufW);
546 return retval;
549 /*************************************************************************
550 * @ [SHLWAPI.23]
552 * Convert a GUID to a string.
554 * PARAMS
555 * guid [I] GUID to convert
556 * lpszDest [O] Destination for string
557 * cchMax [I] Length of output buffer
559 * RETURNS
560 * The length of the string created.
562 INT WINAPI SHStringFromGUIDA(REFGUID guid, LPSTR lpszDest, INT cchMax)
564 char xguid[40];
565 INT iLen;
567 TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
569 sprintf(xguid, "{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}",
570 guid->Data1, guid->Data2, guid->Data3,
571 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
572 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
574 iLen = strlen(xguid) + 1;
576 if (iLen > cchMax)
577 return 0;
578 memcpy(lpszDest, xguid, iLen);
579 return iLen;
582 /*************************************************************************
583 * @ [SHLWAPI.24]
585 * Convert a GUID to a string.
587 * PARAMS
588 * guid [I] GUID to convert
589 * str [O] Destination for string
590 * cmax [I] Length of output buffer
592 * RETURNS
593 * The length of the string created.
595 INT WINAPI SHStringFromGUIDW(REFGUID guid, LPWSTR lpszDest, INT cchMax)
597 WCHAR xguid[40];
598 INT iLen;
599 static const WCHAR wszFormat[] = {'{','%','0','8','l','X','-','%','0','4','X','-','%','0','4','X','-',
600 '%','0','2','X','%','0','2','X','-','%','0','2','X','%','0','2','X','%','0','2','X','%','0','2',
601 'X','%','0','2','X','%','0','2','X','}',0};
603 TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
605 sprintfW(xguid, wszFormat, guid->Data1, guid->Data2, guid->Data3,
606 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
607 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
609 iLen = strlenW(xguid) + 1;
611 if (iLen > cchMax)
612 return 0;
613 memcpy(lpszDest, xguid, iLen*sizeof(WCHAR));
614 return iLen;
617 /*************************************************************************
618 * @ [SHLWAPI.29]
620 * Determine if a Unicode character is a space.
622 * PARAMS
623 * wc [I] Character to check.
625 * RETURNS
626 * TRUE, if wc is a space,
627 * FALSE otherwise.
629 BOOL WINAPI IsCharSpaceW(WCHAR wc)
631 WORD CharType;
633 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_SPACE);
636 /*************************************************************************
637 * @ [SHLWAPI.30]
639 * Determine if a Unicode character is a blank.
641 * PARAMS
642 * wc [I] Character to check.
644 * RETURNS
645 * TRUE, if wc is a blank,
646 * FALSE otherwise.
649 BOOL WINAPI IsCharBlankW(WCHAR wc)
651 WORD CharType;
653 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_BLANK);
656 /*************************************************************************
657 * @ [SHLWAPI.31]
659 * Determine if a Unicode character is punctuation.
661 * PARAMS
662 * wc [I] Character to check.
664 * RETURNS
665 * TRUE, if wc is punctuation,
666 * FALSE otherwise.
668 BOOL WINAPI IsCharPunctW(WCHAR wc)
670 WORD CharType;
672 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_PUNCT);
675 /*************************************************************************
676 * @ [SHLWAPI.32]
678 * Determine if a Unicode character is a control character.
680 * PARAMS
681 * wc [I] Character to check.
683 * RETURNS
684 * TRUE, if wc is a control character,
685 * FALSE otherwise.
687 BOOL WINAPI IsCharCntrlW(WCHAR wc)
689 WORD CharType;
691 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_CNTRL);
694 /*************************************************************************
695 * @ [SHLWAPI.33]
697 * Determine if a Unicode character is a digit.
699 * PARAMS
700 * wc [I] Character to check.
702 * RETURNS
703 * TRUE, if wc is a digit,
704 * FALSE otherwise.
706 BOOL WINAPI IsCharDigitW(WCHAR wc)
708 WORD CharType;
710 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_DIGIT);
713 /*************************************************************************
714 * @ [SHLWAPI.34]
716 * Determine if a Unicode character is a hex digit.
718 * PARAMS
719 * wc [I] Character to check.
721 * RETURNS
722 * TRUE, if wc is a hex digit,
723 * FALSE otherwise.
725 BOOL WINAPI IsCharXDigitW(WCHAR wc)
727 WORD CharType;
729 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_XDIGIT);
732 /*************************************************************************
733 * @ [SHLWAPI.35]
736 BOOL WINAPI GetStringType3ExW(LPWSTR src, INT count, LPWORD type)
738 return GetStringTypeW(CT_CTYPE3, src, count, type);
741 /*************************************************************************
742 * @ [SHLWAPI.151]
744 * Compare two Ascii strings up to a given length.
746 * PARAMS
747 * lpszSrc [I] Source string
748 * lpszCmp [I] String to compare to lpszSrc
749 * len [I] Maximum length
751 * RETURNS
752 * A number greater than, less than or equal to 0 depending on whether
753 * lpszSrc is greater than, less than or equal to lpszCmp.
755 DWORD WINAPI StrCmpNCA(LPCSTR lpszSrc, LPCSTR lpszCmp, INT len)
757 return StrCmpNA(lpszSrc, lpszCmp, len);
760 /*************************************************************************
761 * @ [SHLWAPI.152]
763 * Unicode version of StrCmpNCA.
765 DWORD WINAPI StrCmpNCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, INT len)
767 return StrCmpNW(lpszSrc, lpszCmp, len);
770 /*************************************************************************
771 * @ [SHLWAPI.153]
773 * Compare two Ascii strings up to a given length, ignoring case.
775 * PARAMS
776 * lpszSrc [I] Source string
777 * lpszCmp [I] String to compare to lpszSrc
778 * len [I] Maximum length
780 * RETURNS
781 * A number greater than, less than or equal to 0 depending on whether
782 * lpszSrc is greater than, less than or equal to lpszCmp.
784 DWORD WINAPI StrCmpNICA(LPCSTR lpszSrc, LPCSTR lpszCmp, DWORD len)
786 return StrCmpNIA(lpszSrc, lpszCmp, len);
789 /*************************************************************************
790 * @ [SHLWAPI.154]
792 * Unicode version of StrCmpNICA.
794 DWORD WINAPI StrCmpNICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, DWORD len)
796 return StrCmpNIW(lpszSrc, lpszCmp, len);
799 /*************************************************************************
800 * @ [SHLWAPI.155]
802 * Compare two Ascii strings.
804 * PARAMS
805 * lpszSrc [I] Source string
806 * lpszCmp [I] String to compare to lpszSrc
808 * RETURNS
809 * A number greater than, less than or equal to 0 depending on whether
810 * lpszSrc is greater than, less than or equal to lpszCmp.
812 DWORD WINAPI StrCmpCA(LPCSTR lpszSrc, LPCSTR lpszCmp)
814 return lstrcmpA(lpszSrc, lpszCmp);
817 /*************************************************************************
818 * @ [SHLWAPI.156]
820 * Unicode version of StrCmpCA.
822 DWORD WINAPI StrCmpCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
824 return lstrcmpW(lpszSrc, lpszCmp);
827 /*************************************************************************
828 * @ [SHLWAPI.157]
830 * Compare two Ascii strings, ignoring case.
832 * PARAMS
833 * lpszSrc [I] Source string
834 * lpszCmp [I] String to compare to lpszSrc
836 * RETURNS
837 * A number greater than, less than or equal to 0 depending on whether
838 * lpszSrc is greater than, less than or equal to lpszCmp.
840 DWORD WINAPI StrCmpICA(LPCSTR lpszSrc, LPCSTR lpszCmp)
842 return lstrcmpiA(lpszSrc, lpszCmp);
845 /*************************************************************************
846 * @ [SHLWAPI.158]
848 * Unicode version of StrCmpICA.
850 DWORD WINAPI StrCmpICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
852 return lstrcmpiW(lpszSrc, lpszCmp);
855 /*************************************************************************
856 * @ [SHLWAPI.160]
858 * Get an identification string for the OS and explorer.
860 * PARAMS
861 * lpszDest [O] Destination for Id string
862 * dwDestLen [I] Length of lpszDest
864 * RETURNS
865 * TRUE, If the string was created successfully
866 * FALSE, Otherwise
868 BOOL WINAPI SHAboutInfoA(LPSTR lpszDest, DWORD dwDestLen)
870 WCHAR buff[2084];
872 TRACE("(%p,%d)\n", lpszDest, dwDestLen);
874 if (lpszDest && SHAboutInfoW(buff, dwDestLen))
876 WideCharToMultiByte(CP_ACP, 0, buff, -1, lpszDest, dwDestLen, NULL, NULL);
877 return TRUE;
879 return FALSE;
882 /*************************************************************************
883 * @ [SHLWAPI.161]
885 * Unicode version of SHAboutInfoA.
887 BOOL WINAPI SHAboutInfoW(LPWSTR lpszDest, DWORD dwDestLen)
889 static const WCHAR szIEKey[] = { 'S','O','F','T','W','A','R','E','\\',
890 'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
891 ' ','E','x','p','l','o','r','e','r','\0' };
892 static const WCHAR szWinNtKey[] = { 'S','O','F','T','W','A','R','E','\\',
893 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s',' ',
894 'N','T','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
895 static const WCHAR szWinKey[] = { 'S','O','F','T','W','A','R','E','\\',
896 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
897 'C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
898 static const WCHAR szRegKey[] = { 'S','O','F','T','W','A','R','E','\\',
899 'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
900 ' ','E','x','p','l','o','r','e','r','\\',
901 'R','e','g','i','s','t','r','a','t','i','o','n','\0' };
902 static const WCHAR szVersion[] = { 'V','e','r','s','i','o','n','\0' };
903 static const WCHAR szCustomized[] = { 'C','u','s','t','o','m','i','z','e','d',
904 'V','e','r','s','i','o','n','\0' };
905 static const WCHAR szOwner[] = { 'R','e','g','i','s','t','e','r','e','d',
906 'O','w','n','e','r','\0' };
907 static const WCHAR szOrg[] = { 'R','e','g','i','s','t','e','r','e','d',
908 'O','r','g','a','n','i','z','a','t','i','o','n','\0' };
909 static const WCHAR szProduct[] = { 'P','r','o','d','u','c','t','I','d','\0' };
910 static const WCHAR szUpdate[] = { 'I','E','A','K',
911 'U','p','d','a','t','e','U','r','l','\0' };
912 static const WCHAR szHelp[] = { 'I','E','A','K',
913 'H','e','l','p','S','t','r','i','n','g','\0' };
914 WCHAR buff[2084];
915 HKEY hReg;
916 DWORD dwType, dwLen;
918 TRACE("(%p,%d)\n", lpszDest, dwDestLen);
920 if (!lpszDest)
921 return FALSE;
923 *lpszDest = '\0';
925 /* Try the NT key first, followed by 95/98 key */
926 if (RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinNtKey, 0, KEY_READ, &hReg) &&
927 RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinKey, 0, KEY_READ, &hReg))
928 return FALSE;
930 /* OS Version */
931 buff[0] = '\0';
932 dwLen = 30;
933 if (!SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey, szVersion, &dwType, buff, &dwLen))
935 DWORD dwStrLen = strlenW(buff);
936 dwLen = 30 - dwStrLen;
937 SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey,
938 szCustomized, &dwType, buff+dwStrLen, &dwLen);
940 StrCatBuffW(lpszDest, buff, dwDestLen);
942 /* ~Registered Owner */
943 buff[0] = '~';
944 dwLen = 256;
945 if (SHGetValueW(hReg, szOwner, 0, &dwType, buff+1, &dwLen))
946 buff[1] = '\0';
947 StrCatBuffW(lpszDest, buff, dwDestLen);
949 /* ~Registered Organization */
950 dwLen = 256;
951 if (SHGetValueW(hReg, szOrg, 0, &dwType, buff+1, &dwLen))
952 buff[1] = '\0';
953 StrCatBuffW(lpszDest, buff, dwDestLen);
955 /* FIXME: Not sure where this number comes from */
956 buff[0] = '~';
957 buff[1] = '0';
958 buff[2] = '\0';
959 StrCatBuffW(lpszDest, buff, dwDestLen);
961 /* ~Product Id */
962 dwLen = 256;
963 if (SHGetValueW(HKEY_LOCAL_MACHINE, szRegKey, szProduct, &dwType, buff+1, &dwLen))
964 buff[1] = '\0';
965 StrCatBuffW(lpszDest, buff, dwDestLen);
967 /* ~IE Update Url */
968 dwLen = 2048;
969 if(SHGetValueW(HKEY_LOCAL_MACHINE, szWinKey, szUpdate, &dwType, buff+1, &dwLen))
970 buff[1] = '\0';
971 StrCatBuffW(lpszDest, buff, dwDestLen);
973 /* ~IE Help String */
974 dwLen = 256;
975 if(SHGetValueW(hReg, szHelp, 0, &dwType, buff+1, &dwLen))
976 buff[1] = '\0';
977 StrCatBuffW(lpszDest, buff, dwDestLen);
979 RegCloseKey(hReg);
980 return TRUE;
983 /*************************************************************************
984 * @ [SHLWAPI.163]
986 * Call IOleCommandTarget_QueryStatus() on an object.
988 * PARAMS
989 * lpUnknown [I] Object supporting the IOleCommandTarget interface
990 * pguidCmdGroup [I] GUID for the command group
991 * cCmds [I]
992 * prgCmds [O] Commands
993 * pCmdText [O] Command text
995 * RETURNS
996 * Success: S_OK.
997 * Failure: E_FAIL, if lpUnknown is NULL.
998 * E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
999 * Otherwise, an error code from IOleCommandTarget_QueryStatus().
1001 HRESULT WINAPI IUnknown_QueryStatus(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
1002 ULONG cCmds, OLECMD *prgCmds, OLECMDTEXT* pCmdText)
1004 HRESULT hRet = E_FAIL;
1006 TRACE("(%p,%p,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, cCmds, prgCmds, pCmdText);
1008 if (lpUnknown)
1010 IOleCommandTarget* lpOle;
1012 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
1013 (void**)&lpOle);
1015 if (SUCCEEDED(hRet) && lpOle)
1017 hRet = IOleCommandTarget_QueryStatus(lpOle, pguidCmdGroup, cCmds,
1018 prgCmds, pCmdText);
1019 IOleCommandTarget_Release(lpOle);
1022 return hRet;
1025 /*************************************************************************
1026 * @ [SHLWAPI.164]
1028 * Call IOleCommandTarget_Exec() on an object.
1030 * PARAMS
1031 * lpUnknown [I] Object supporting the IOleCommandTarget interface
1032 * pguidCmdGroup [I] GUID for the command group
1034 * RETURNS
1035 * Success: S_OK.
1036 * Failure: E_FAIL, if lpUnknown is NULL.
1037 * E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
1038 * Otherwise, an error code from IOleCommandTarget_Exec().
1040 HRESULT WINAPI IUnknown_Exec(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
1041 DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
1042 VARIANT* pvaOut)
1044 HRESULT hRet = E_FAIL;
1046 TRACE("(%p,%p,%d,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, nCmdID,
1047 nCmdexecopt, pvaIn, pvaOut);
1049 if (lpUnknown)
1051 IOleCommandTarget* lpOle;
1053 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
1054 (void**)&lpOle);
1055 if (SUCCEEDED(hRet) && lpOle)
1057 hRet = IOleCommandTarget_Exec(lpOle, pguidCmdGroup, nCmdID,
1058 nCmdexecopt, pvaIn, pvaOut);
1059 IOleCommandTarget_Release(lpOle);
1062 return hRet;
1065 /*************************************************************************
1066 * @ [SHLWAPI.165]
1068 * Retrieve, modify, and re-set a value from a window.
1070 * PARAMS
1071 * hWnd [I] Window to get value from
1072 * offset [I] Offset of value
1073 * wMask [I] Mask for uiFlags
1074 * wFlags [I] Bits to set in window value
1076 * RETURNS
1077 * The new value as it was set, or 0 if any parameter is invalid.
1079 * NOTES
1080 * Any bits set in uiMask are cleared from the value, then any bits set in
1081 * uiFlags are set in the value.
1083 LONG WINAPI SHSetWindowBits(HWND hwnd, INT offset, UINT wMask, UINT wFlags)
1085 LONG ret = GetWindowLongA(hwnd, offset);
1086 LONG newFlags = (wFlags & wMask) | (ret & ~wFlags);
1088 if (newFlags != ret)
1089 ret = SetWindowLongA(hwnd, offset, newFlags);
1090 return ret;
1093 /*************************************************************************
1094 * @ [SHLWAPI.167]
1096 * Change a window's parent.
1098 * PARAMS
1099 * hWnd [I] Window to change parent of
1100 * hWndParent [I] New parent window
1102 * RETURNS
1103 * The old parent of hWnd.
1105 * NOTES
1106 * If hWndParent is NULL (desktop), the window style is changed to WS_POPUP.
1107 * If hWndParent is NOT NULL then we set the WS_CHILD style.
1109 HWND WINAPI SHSetParentHwnd(HWND hWnd, HWND hWndParent)
1111 TRACE("%p, %p\n", hWnd, hWndParent);
1113 if(GetParent(hWnd) == hWndParent)
1114 return 0;
1116 if(hWndParent)
1117 SHSetWindowBits(hWnd, GWL_STYLE, WS_CHILD, WS_CHILD);
1118 else
1119 SHSetWindowBits(hWnd, GWL_STYLE, WS_POPUP, WS_POPUP);
1121 return SetParent(hWnd, hWndParent);
1124 /*************************************************************************
1125 * @ [SHLWAPI.168]
1127 * Locate and advise a connection point in an IConnectionPointContainer object.
1129 * PARAMS
1130 * lpUnkSink [I] Sink for the connection point advise call
1131 * riid [I] REFIID of connection point to advise
1132 * bAdviseOnly [I] TRUE = Advise only, FALSE = Unadvise first
1133 * lpUnknown [I] Object supporting the IConnectionPointContainer interface
1134 * lpCookie [O] Pointer to connection point cookie
1135 * lppCP [O] Destination for the IConnectionPoint found
1137 * RETURNS
1138 * Success: S_OK. If lppCP is non-NULL, it is filled with the IConnectionPoint
1139 * that was advised. The caller is responsible for releasing it.
1140 * Failure: E_FAIL, if any arguments are invalid.
1141 * E_NOINTERFACE, if lpUnknown isn't an IConnectionPointContainer,
1142 * Or an HRESULT error code if any call fails.
1144 HRESULT WINAPI ConnectToConnectionPoint(IUnknown* lpUnkSink, REFIID riid, BOOL bAdviseOnly,
1145 IUnknown* lpUnknown, LPDWORD lpCookie,
1146 IConnectionPoint **lppCP)
1148 HRESULT hRet;
1149 IConnectionPointContainer* lpContainer;
1150 IConnectionPoint *lpCP;
1152 if(!lpUnknown || (bAdviseOnly && !lpUnkSink))
1153 return E_FAIL;
1155 if(lppCP)
1156 *lppCP = NULL;
1158 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer,
1159 (void**)&lpContainer);
1160 if (SUCCEEDED(hRet))
1162 hRet = IConnectionPointContainer_FindConnectionPoint(lpContainer, riid, &lpCP);
1164 if (SUCCEEDED(hRet))
1166 if(!bAdviseOnly)
1167 hRet = IConnectionPoint_Unadvise(lpCP, *lpCookie);
1168 hRet = IConnectionPoint_Advise(lpCP, lpUnkSink, lpCookie);
1170 if (FAILED(hRet))
1171 *lpCookie = 0;
1173 if (lppCP && SUCCEEDED(hRet))
1174 *lppCP = lpCP; /* Caller keeps the interface */
1175 else
1176 IConnectionPoint_Release(lpCP); /* Release it */
1179 IUnknown_Release(lpContainer);
1181 return hRet;
1184 /*************************************************************************
1185 * @ [SHLWAPI.169]
1187 * Release an interface.
1189 * PARAMS
1190 * lpUnknown [I] Object to release
1192 * RETURNS
1193 * Nothing.
1195 DWORD WINAPI IUnknown_AtomicRelease(IUnknown ** lpUnknown)
1197 IUnknown *temp;
1199 TRACE("(%p)\n",lpUnknown);
1201 if(!lpUnknown || !*((LPDWORD)lpUnknown)) return 0;
1202 temp = *lpUnknown;
1203 *lpUnknown = NULL;
1205 TRACE("doing Release\n");
1207 return IUnknown_Release(temp);
1210 /*************************************************************************
1211 * @ [SHLWAPI.170]
1213 * Skip '//' if present in a string.
1215 * PARAMS
1216 * lpszSrc [I] String to check for '//'
1218 * RETURNS
1219 * Success: The next character after the '//' or the string if not present
1220 * Failure: NULL, if lpszStr is NULL.
1222 LPCSTR WINAPI PathSkipLeadingSlashesA(LPCSTR lpszSrc)
1224 if (lpszSrc && lpszSrc[0] == '/' && lpszSrc[1] == '/')
1225 lpszSrc += 2;
1226 return lpszSrc;
1229 /*************************************************************************
1230 * @ [SHLWAPI.171]
1232 * Check if two interfaces come from the same object.
1234 * PARAMS
1235 * lpInt1 [I] Interface to check against lpInt2.
1236 * lpInt2 [I] Interface to check against lpInt1.
1238 * RETURNS
1239 * TRUE, If the interfaces come from the same object.
1240 * FALSE Otherwise.
1242 BOOL WINAPI SHIsSameObject(IUnknown* lpInt1, IUnknown* lpInt2)
1244 LPVOID lpUnknown1, lpUnknown2;
1246 TRACE("%p %p\n", lpInt1, lpInt2);
1248 if (!lpInt1 || !lpInt2)
1249 return FALSE;
1251 if (lpInt1 == lpInt2)
1252 return TRUE;
1254 if (!SUCCEEDED(IUnknown_QueryInterface(lpInt1, &IID_IUnknown,
1255 (LPVOID *)&lpUnknown1)))
1256 return FALSE;
1258 if (!SUCCEEDED(IUnknown_QueryInterface(lpInt2, &IID_IUnknown,
1259 (LPVOID *)&lpUnknown2)))
1260 return FALSE;
1262 if (lpUnknown1 == lpUnknown2)
1263 return TRUE;
1265 return FALSE;
1268 /*************************************************************************
1269 * @ [SHLWAPI.172]
1271 * Get the window handle of an object.
1273 * PARAMS
1274 * lpUnknown [I] Object to get the window handle of
1275 * lphWnd [O] Destination for window handle
1277 * RETURNS
1278 * Success: S_OK. lphWnd contains the objects window handle.
1279 * Failure: An HRESULT error code.
1281 * NOTES
1282 * lpUnknown is expected to support one of the following interfaces:
1283 * IOleWindow(), IInternetSecurityMgrSite(), or IShellView().
1285 HRESULT WINAPI IUnknown_GetWindow(IUnknown *lpUnknown, HWND *lphWnd)
1287 IUnknown *lpOle;
1288 HRESULT hRet = E_FAIL;
1290 TRACE("(%p,%p)\n", lpUnknown, lphWnd);
1292 if (!lpUnknown)
1293 return hRet;
1295 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleWindow, (void**)&lpOle);
1297 if (FAILED(hRet))
1299 hRet = IUnknown_QueryInterface(lpUnknown,&IID_IShellView, (void**)&lpOle);
1301 if (FAILED(hRet))
1303 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInternetSecurityMgrSite,
1304 (void**)&lpOle);
1308 if (SUCCEEDED(hRet))
1310 /* Lazyness here - Since GetWindow() is the first method for the above 3
1311 * interfaces, we use the same call for them all.
1313 hRet = IOleWindow_GetWindow((IOleWindow*)lpOle, lphWnd);
1314 IUnknown_Release(lpOle);
1315 if (lphWnd)
1316 TRACE("Returning HWND=%p\n", *lphWnd);
1319 return hRet;
1322 /*************************************************************************
1323 * @ [SHLWAPI.173]
1325 * Call a method on as as yet unidentified object.
1327 * PARAMS
1328 * pUnk [I] Object supporting the unidentified interface,
1329 * arg [I] Argument for the call on the object.
1331 * RETURNS
1332 * S_OK.
1334 HRESULT WINAPI IUnknown_SetOwner(IUnknown *pUnk, ULONG arg)
1336 static const GUID guid_173 = {
1337 0x5836fb00, 0x8187, 0x11cf, { 0xa1,0x2b,0x00,0xaa,0x00,0x4a,0xe8,0x37 }
1339 IMalloc *pUnk2;
1341 TRACE("(%p,%d)\n", pUnk, arg);
1343 /* Note: arg may not be a ULONG and pUnk2 is for sure not an IMalloc -
1344 * We use this interface as its vtable entry is compatible with the
1345 * object in question.
1346 * FIXME: Find out what this object is and where it should be defined.
1348 if (pUnk &&
1349 SUCCEEDED(IUnknown_QueryInterface(pUnk, &guid_173, (void**)&pUnk2)))
1351 IMalloc_Alloc(pUnk2, arg); /* Faked call!! */
1352 IMalloc_Release(pUnk2);
1354 return S_OK;
1357 /*************************************************************************
1358 * @ [SHLWAPI.174]
1360 * Call either IObjectWithSite_SetSite() or IInternetSecurityManager_SetSecuritySite() on
1361 * an object.
1364 HRESULT WINAPI IUnknown_SetSite(
1365 IUnknown *obj, /* [in] OLE object */
1366 IUnknown *site) /* [in] Site interface */
1368 HRESULT hr;
1369 IObjectWithSite *iobjwithsite;
1370 IInternetSecurityManager *isecmgr;
1372 if (!obj) return E_FAIL;
1374 hr = IUnknown_QueryInterface(obj, &IID_IObjectWithSite, (LPVOID *)&iobjwithsite);
1375 TRACE("IID_IObjectWithSite QI ret=%08x, %p\n", hr, iobjwithsite);
1376 if (SUCCEEDED(hr))
1378 hr = IObjectWithSite_SetSite(iobjwithsite, site);
1379 TRACE("done IObjectWithSite_SetSite ret=%08x\n", hr);
1380 IUnknown_Release(iobjwithsite);
1382 else
1384 hr = IUnknown_QueryInterface(obj, &IID_IInternetSecurityManager, (LPVOID *)&isecmgr);
1385 TRACE("IID_IInternetSecurityManager QI ret=%08x, %p\n", hr, isecmgr);
1386 if (FAILED(hr)) return hr;
1388 hr = IInternetSecurityManager_SetSecuritySite(isecmgr, (IInternetSecurityMgrSite *)site);
1389 TRACE("done IInternetSecurityManager_SetSecuritySite ret=%08x\n", hr);
1390 IUnknown_Release(isecmgr);
1392 return hr;
1395 /*************************************************************************
1396 * @ [SHLWAPI.175]
1398 * Call IPersist_GetClassID() on an object.
1400 * PARAMS
1401 * lpUnknown [I] Object supporting the IPersist interface
1402 * lpClassId [O] Destination for Class Id
1404 * RETURNS
1405 * Success: S_OK. lpClassId contains the Class Id requested.
1406 * Failure: E_FAIL, If lpUnknown is NULL,
1407 * E_NOINTERFACE If lpUnknown does not support IPersist,
1408 * Or an HRESULT error code.
1410 HRESULT WINAPI IUnknown_GetClassID(IUnknown *lpUnknown, CLSID* lpClassId)
1412 IPersist* lpPersist;
1413 HRESULT hRet = E_FAIL;
1415 TRACE("(%p,%p)\n", lpUnknown, debugstr_guid(lpClassId));
1417 if (lpUnknown)
1419 hRet = IUnknown_QueryInterface(lpUnknown,&IID_IPersist,(void**)&lpPersist);
1420 if (SUCCEEDED(hRet))
1422 IPersist_GetClassID(lpPersist, lpClassId);
1423 IPersist_Release(lpPersist);
1426 return hRet;
1429 /*************************************************************************
1430 * @ [SHLWAPI.176]
1432 * Retrieve a Service Interface from an object.
1434 * PARAMS
1435 * lpUnknown [I] Object to get an IServiceProvider interface from
1436 * sid [I] Service ID for IServiceProvider_QueryService() call
1437 * riid [I] Function requested for QueryService call
1438 * lppOut [O] Destination for the service interface pointer
1440 * RETURNS
1441 * Success: S_OK. lppOut contains an object providing the requested service
1442 * Failure: An HRESULT error code
1444 * NOTES
1445 * lpUnknown is expected to support the IServiceProvider interface.
1447 HRESULT WINAPI IUnknown_QueryService(IUnknown* lpUnknown, REFGUID sid, REFIID riid,
1448 LPVOID *lppOut)
1450 IServiceProvider* pService = NULL;
1451 HRESULT hRet;
1453 if (!lppOut)
1454 return E_FAIL;
1456 *lppOut = NULL;
1458 if (!lpUnknown)
1459 return E_FAIL;
1461 /* Get an IServiceProvider interface from the object */
1462 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IServiceProvider,
1463 (LPVOID*)&pService);
1465 if (!hRet && pService)
1467 TRACE("QueryInterface returned (IServiceProvider*)%p\n", pService);
1469 /* Get a Service interface from the object */
1470 hRet = IServiceProvider_QueryService(pService, sid, riid, lppOut);
1472 TRACE("(IServiceProvider*)%p returned (IUnknown*)%p\n", pService, *lppOut);
1474 /* Release the IServiceProvider interface */
1475 IUnknown_Release(pService);
1477 return hRet;
1480 /*************************************************************************
1481 * @ [SHLWAPI.177]
1483 * Loads a popup menu.
1485 * PARAMS
1486 * hInst [I] Instance handle
1487 * szName [I] Menu name
1489 * RETURNS
1490 * Success: TRUE.
1491 * Failure: FALSE.
1493 BOOL WINAPI SHLoadMenuPopup(HINSTANCE hInst, LPCWSTR szName)
1495 HMENU hMenu, hSubMenu;
1497 if ((hMenu = LoadMenuW(hInst, szName)))
1499 if ((hSubMenu = GetSubMenu(hMenu, 0)))
1500 RemoveMenu(hMenu, 0, MF_BYPOSITION);
1502 DestroyMenu(hMenu);
1503 return TRUE;
1505 return FALSE;
1508 typedef struct _enumWndData
1510 UINT uiMsgId;
1511 WPARAM wParam;
1512 LPARAM lParam;
1513 LRESULT (WINAPI *pfnPost)(HWND,UINT,WPARAM,LPARAM);
1514 } enumWndData;
1516 /* Callback for SHLWAPI_178 */
1517 static BOOL CALLBACK SHLWAPI_EnumChildProc(HWND hWnd, LPARAM lParam)
1519 enumWndData *data = (enumWndData *)lParam;
1521 TRACE("(%p,%p)\n", hWnd, data);
1522 data->pfnPost(hWnd, data->uiMsgId, data->wParam, data->lParam);
1523 return TRUE;
1526 /*************************************************************************
1527 * @ [SHLWAPI.178]
1529 * Send or post a message to every child of a window.
1531 * PARAMS
1532 * hWnd [I] Window whose children will get the messages
1533 * uiMsgId [I] Message Id
1534 * wParam [I] WPARAM of message
1535 * lParam [I] LPARAM of message
1536 * bSend [I] TRUE = Use SendMessageA(), FALSE = Use PostMessageA()
1538 * RETURNS
1539 * Nothing.
1541 * NOTES
1542 * The appropriate ASCII or Unicode function is called for the window.
1544 void WINAPI SHPropagateMessage(HWND hWnd, UINT uiMsgId, WPARAM wParam, LPARAM lParam, BOOL bSend)
1546 enumWndData data;
1548 TRACE("(%p,%u,%ld,%ld,%d)\n", hWnd, uiMsgId, wParam, lParam, bSend);
1550 if(hWnd)
1552 data.uiMsgId = uiMsgId;
1553 data.wParam = wParam;
1554 data.lParam = lParam;
1556 if (bSend)
1557 data.pfnPost = IsWindowUnicode(hWnd) ? (void*)SendMessageW : (void*)SendMessageA;
1558 else
1559 data.pfnPost = IsWindowUnicode(hWnd) ? (void*)PostMessageW : (void*)PostMessageA;
1561 EnumChildWindows(hWnd, SHLWAPI_EnumChildProc, (LPARAM)&data);
1565 /*************************************************************************
1566 * @ [SHLWAPI.180]
1568 * Remove all sub-menus from a menu.
1570 * PARAMS
1571 * hMenu [I] Menu to remove sub-menus from
1573 * RETURNS
1574 * Success: 0. All sub-menus under hMenu are removed
1575 * Failure: -1, if any parameter is invalid
1577 DWORD WINAPI SHRemoveAllSubMenus(HMENU hMenu)
1579 int iItemCount = GetMenuItemCount(hMenu) - 1;
1580 while (iItemCount >= 0)
1582 HMENU hSubMenu = GetSubMenu(hMenu, iItemCount);
1583 if (hSubMenu)
1584 RemoveMenu(hMenu, iItemCount, MF_BYPOSITION);
1585 iItemCount--;
1587 return iItemCount;
1590 /*************************************************************************
1591 * @ [SHLWAPI.181]
1593 * Enable or disable a menu item.
1595 * PARAMS
1596 * hMenu [I] Menu holding menu item
1597 * uID [I] ID of menu item to enable/disable
1598 * bEnable [I] Whether to enable (TRUE) or disable (FALSE) the item.
1600 * RETURNS
1601 * The return code from EnableMenuItem.
1603 UINT WINAPI SHEnableMenuItem(HMENU hMenu, UINT wItemID, BOOL bEnable)
1605 return EnableMenuItem(hMenu, wItemID, bEnable ? MF_ENABLED : MF_GRAYED);
1608 /*************************************************************************
1609 * @ [SHLWAPI.182]
1611 * Check or uncheck a menu item.
1613 * PARAMS
1614 * hMenu [I] Menu holding menu item
1615 * uID [I] ID of menu item to check/uncheck
1616 * bCheck [I] Whether to check (TRUE) or uncheck (FALSE) the item.
1618 * RETURNS
1619 * The return code from CheckMenuItem.
1621 DWORD WINAPI SHCheckMenuItem(HMENU hMenu, UINT uID, BOOL bCheck)
1623 return CheckMenuItem(hMenu, uID, bCheck ? MF_CHECKED : MF_UNCHECKED);
1626 /*************************************************************************
1627 * @ [SHLWAPI.183]
1629 * Register a window class if it isn't already.
1631 * PARAMS
1632 * lpWndClass [I] Window class to register
1634 * RETURNS
1635 * The result of the RegisterClassA call.
1637 DWORD WINAPI SHRegisterClassA(WNDCLASSA *wndclass)
1639 WNDCLASSA wca;
1640 if (GetClassInfoA(wndclass->hInstance, wndclass->lpszClassName, &wca))
1641 return TRUE;
1642 return (DWORD)RegisterClassA(wndclass);
1645 /*************************************************************************
1646 * @ [SHLWAPI.186]
1648 BOOL WINAPI SHSimulateDrop(IDropTarget *pDrop, IDataObject *pDataObj,
1649 DWORD grfKeyState, PPOINTL lpPt, DWORD* pdwEffect)
1651 DWORD dwEffect = DROPEFFECT_LINK | DROPEFFECT_MOVE | DROPEFFECT_COPY;
1652 POINTL pt = { 0, 0 };
1654 if (!lpPt)
1655 lpPt = &pt;
1657 if (!pdwEffect)
1658 pdwEffect = &dwEffect;
1660 IDropTarget_DragEnter(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1662 if (*pdwEffect)
1663 return IDropTarget_Drop(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1665 IDropTarget_DragLeave(pDrop);
1666 return TRUE;
1669 /*************************************************************************
1670 * @ [SHLWAPI.187]
1672 * Call IPersistPropertyBag_Load() on an object.
1674 * PARAMS
1675 * lpUnknown [I] Object supporting the IPersistPropertyBag interface
1676 * lpPropBag [O] Destination for loaded IPropertyBag
1678 * RETURNS
1679 * Success: S_OK.
1680 * Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1682 DWORD WINAPI SHLoadFromPropertyBag(IUnknown *lpUnknown, IPropertyBag* lpPropBag)
1684 IPersistPropertyBag* lpPPBag;
1685 HRESULT hRet = E_FAIL;
1687 TRACE("(%p,%p)\n", lpUnknown, lpPropBag);
1689 if (lpUnknown)
1691 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IPersistPropertyBag,
1692 (void**)&lpPPBag);
1693 if (SUCCEEDED(hRet) && lpPPBag)
1695 hRet = IPersistPropertyBag_Load(lpPPBag, lpPropBag, NULL);
1696 IPersistPropertyBag_Release(lpPPBag);
1699 return hRet;
1702 /*************************************************************************
1703 * @ [SHLWAPI.188]
1705 * Call IOleControlSite_TranslateAccelerator() on an object.
1707 * PARAMS
1708 * lpUnknown [I] Object supporting the IOleControlSite interface.
1709 * lpMsg [I] Key message to be processed.
1710 * dwModifiers [I] Flags containing the state of the modifier keys.
1712 * RETURNS
1713 * Success: S_OK.
1714 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
1716 HRESULT WINAPI IUnknown_TranslateAcceleratorOCS(IUnknown *lpUnknown, LPMSG lpMsg, DWORD dwModifiers)
1718 IOleControlSite* lpCSite = NULL;
1719 HRESULT hRet = E_INVALIDARG;
1721 TRACE("(%p,%p,0x%08x)\n", lpUnknown, lpMsg, dwModifiers);
1722 if (lpUnknown)
1724 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1725 (void**)&lpCSite);
1726 if (SUCCEEDED(hRet) && lpCSite)
1728 hRet = IOleControlSite_TranslateAccelerator(lpCSite, lpMsg, dwModifiers);
1729 IOleControlSite_Release(lpCSite);
1732 return hRet;
1736 /*************************************************************************
1737 * @ [SHLWAPI.189]
1739 * Call IOleControlSite_OnFocus() on an object.
1741 * PARAMS
1742 * lpUnknown [I] Object supporting the IOleControlSite interface.
1743 * fGotFocus [I] Whether focus was gained (TRUE) or lost (FALSE).
1745 * RETURNS
1746 * Success: S_OK.
1747 * Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1749 HRESULT WINAPI IUnknown_OnFocusOCS(IUnknown *lpUnknown, BOOL fGotFocus)
1751 IOleControlSite* lpCSite = NULL;
1752 HRESULT hRet = E_FAIL;
1754 TRACE("(%p,%s)\n", lpUnknown, fGotFocus ? "TRUE" : "FALSE");
1755 if (lpUnknown)
1757 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1758 (void**)&lpCSite);
1759 if (SUCCEEDED(hRet) && lpCSite)
1761 hRet = IOleControlSite_OnFocus(lpCSite, fGotFocus);
1762 IOleControlSite_Release(lpCSite);
1765 return hRet;
1768 /*************************************************************************
1769 * @ [SHLWAPI.190]
1771 HRESULT WINAPI IUnknown_HandleIRestrict(LPUNKNOWN lpUnknown, PVOID lpArg1,
1772 PVOID lpArg2, PVOID lpArg3, PVOID lpArg4)
1774 /* FIXME: {D12F26B2-D90A-11D0-830D-00AA005B4383} - What object does this represent? */
1775 static const DWORD service_id[] = { 0xd12f26b2, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1776 /* FIXME: {D12F26B1-D90A-11D0-830D-00AA005B4383} - Also Unknown/undocumented */
1777 static const DWORD function_id[] = { 0xd12f26b1, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1778 HRESULT hRet = E_INVALIDARG;
1779 LPUNKNOWN lpUnkInner = NULL; /* FIXME: Real type is unknown */
1781 TRACE("(%p,%p,%p,%p,%p)\n", lpUnknown, lpArg1, lpArg2, lpArg3, lpArg4);
1783 if (lpUnknown && lpArg4)
1785 hRet = IUnknown_QueryService(lpUnknown, (REFGUID)service_id,
1786 (REFGUID)function_id, (void**)&lpUnkInner);
1788 if (SUCCEEDED(hRet) && lpUnkInner)
1790 /* FIXME: The type of service object requested is unknown, however
1791 * testing shows that its first method is called with 4 parameters.
1792 * Fake this by using IParseDisplayName_ParseDisplayName since the
1793 * signature and position in the vtable matches our unknown object type.
1795 hRet = IParseDisplayName_ParseDisplayName((LPPARSEDISPLAYNAME)lpUnkInner,
1796 lpArg1, lpArg2, lpArg3, lpArg4);
1797 IUnknown_Release(lpUnkInner);
1800 return hRet;
1803 /*************************************************************************
1804 * @ [SHLWAPI.192]
1806 * Get a sub-menu from a menu item.
1808 * PARAMS
1809 * hMenu [I] Menu to get sub-menu from
1810 * uID [I] ID of menu item containing sub-menu
1812 * RETURNS
1813 * The sub-menu of the item, or a NULL handle if any parameters are invalid.
1815 HMENU WINAPI SHGetMenuFromID(HMENU hMenu, UINT uID)
1817 MENUITEMINFOW mi;
1819 TRACE("(%p,%u)\n", hMenu, uID);
1821 mi.cbSize = sizeof(mi);
1822 mi.fMask = MIIM_SUBMENU;
1824 if (!GetMenuItemInfoW(hMenu, uID, FALSE, &mi))
1825 return NULL;
1827 return mi.hSubMenu;
1830 /*************************************************************************
1831 * @ [SHLWAPI.193]
1833 * Get the color depth of the primary display.
1835 * PARAMS
1836 * None.
1838 * RETURNS
1839 * The color depth of the primary display.
1841 DWORD WINAPI SHGetCurColorRes(void)
1843 HDC hdc;
1844 DWORD ret;
1846 TRACE("()\n");
1848 hdc = GetDC(0);
1849 ret = GetDeviceCaps(hdc, BITSPIXEL) * GetDeviceCaps(hdc, PLANES);
1850 ReleaseDC(0, hdc);
1851 return ret;
1854 /*************************************************************************
1855 * @ [SHLWAPI.194]
1857 * Wait for a message to arrive, with a timeout.
1859 * PARAMS
1860 * hand [I] Handle to query
1861 * dwTimeout [I] Timeout in ticks or INFINITE to never timeout
1863 * RETURNS
1864 * STATUS_TIMEOUT if no message is received before dwTimeout ticks passes.
1865 * Otherwise returns the value from MsgWaitForMultipleObjectsEx when a
1866 * message is available.
1868 DWORD WINAPI SHWaitForSendMessageThread(HANDLE hand, DWORD dwTimeout)
1870 DWORD dwEndTicks = GetTickCount() + dwTimeout;
1871 DWORD dwRet;
1873 while ((dwRet = MsgWaitForMultipleObjectsEx(1, &hand, dwTimeout, QS_SENDMESSAGE, 0)) == 1)
1875 MSG msg;
1877 PeekMessageW(&msg, NULL, 0, 0, PM_NOREMOVE);
1879 if (dwTimeout != INFINITE)
1881 if ((int)(dwTimeout = dwEndTicks - GetTickCount()) <= 0)
1882 return WAIT_TIMEOUT;
1886 return dwRet;
1889 /*************************************************************************
1890 * @ [SHLWAPI.195]
1892 * Determine if a shell folder can be expanded.
1894 * PARAMS
1895 * lpFolder [I] Parent folder containing the object to test.
1896 * pidl [I] Id of the object to test.
1898 * RETURNS
1899 * Success: S_OK, if the object is expandable, S_FALSE otherwise.
1900 * Failure: E_INVALIDARG, if any argument is invalid.
1902 * NOTES
1903 * If the object to be tested does not expose the IQueryInfo() interface it
1904 * will not be identified as an expandable folder.
1906 HRESULT WINAPI SHIsExpandableFolder(LPSHELLFOLDER lpFolder, LPCITEMIDLIST pidl)
1908 HRESULT hRet = E_INVALIDARG;
1909 IQueryInfo *lpInfo;
1911 if (lpFolder && pidl)
1913 hRet = IShellFolder_GetUIObjectOf(lpFolder, NULL, 1, &pidl, &IID_IQueryInfo,
1914 NULL, (void**)&lpInfo);
1915 if (FAILED(hRet))
1916 hRet = S_FALSE; /* Doesn't expose IQueryInfo */
1917 else
1919 DWORD dwFlags = 0;
1921 /* MSDN states of IQueryInfo_GetInfoFlags() that "This method is not
1922 * currently used". Really? You wouldn't be holding out on me would you?
1924 hRet = IQueryInfo_GetInfoFlags(lpInfo, &dwFlags);
1926 if (SUCCEEDED(hRet))
1928 /* 0x2 is an undocumented flag apparently indicating expandability */
1929 hRet = dwFlags & 0x2 ? S_OK : S_FALSE;
1932 IQueryInfo_Release(lpInfo);
1935 return hRet;
1938 /*************************************************************************
1939 * @ [SHLWAPI.197]
1941 * Blank out a region of text by drawing the background only.
1943 * PARAMS
1944 * hDC [I] Device context to draw in
1945 * pRect [I] Area to draw in
1946 * cRef [I] Color to draw in
1948 * RETURNS
1949 * Nothing.
1951 DWORD WINAPI SHFillRectClr(HDC hDC, LPCRECT pRect, COLORREF cRef)
1953 COLORREF cOldColor = SetBkColor(hDC, cRef);
1954 ExtTextOutA(hDC, 0, 0, ETO_OPAQUE, pRect, 0, 0, 0);
1955 SetBkColor(hDC, cOldColor);
1956 return 0;
1959 /*************************************************************************
1960 * @ [SHLWAPI.198]
1962 * Return the value asociated with a key in a map.
1964 * PARAMS
1965 * lpKeys [I] A list of keys of length iLen
1966 * lpValues [I] A list of values associated with lpKeys, of length iLen
1967 * iLen [I] Length of both lpKeys and lpValues
1968 * iKey [I] The key value to look up in lpKeys
1970 * RETURNS
1971 * The value in lpValues associated with iKey, or -1 if iKey is not
1972 * found in lpKeys.
1974 * NOTES
1975 * - If two elements in the map share the same key, this function returns
1976 * the value closest to the start of the map
1977 * - The native version of this function crashes if lpKeys or lpValues is NULL.
1979 int WINAPI SHSearchMapInt(const int *lpKeys, const int *lpValues, int iLen, int iKey)
1981 if (lpKeys && lpValues)
1983 int i = 0;
1985 while (i < iLen)
1987 if (lpKeys[i] == iKey)
1988 return lpValues[i]; /* Found */
1989 i++;
1992 return -1; /* Not found */
1996 /*************************************************************************
1997 * @ [SHLWAPI.199]
1999 * Copy an interface pointer
2001 * PARAMS
2002 * lppDest [O] Destination for copy
2003 * lpUnknown [I] Source for copy
2005 * RETURNS
2006 * Nothing.
2008 VOID WINAPI IUnknown_Set(IUnknown **lppDest, IUnknown *lpUnknown)
2010 TRACE("(%p,%p)\n", lppDest, lpUnknown);
2012 if (lppDest)
2013 IUnknown_AtomicRelease(lppDest); /* Release existing interface */
2015 if (lpUnknown)
2017 /* Copy */
2018 IUnknown_AddRef(lpUnknown);
2019 *lppDest = lpUnknown;
2023 /*************************************************************************
2024 * @ [SHLWAPI.200]
2027 HRESULT WINAPI MayQSForward(IUnknown* lpUnknown, PVOID lpReserved,
2028 REFGUID riidCmdGrp, ULONG cCmds,
2029 OLECMD *prgCmds, OLECMDTEXT* pCmdText)
2031 FIXME("(%p,%p,%p,%d,%p,%p) - stub\n",
2032 lpUnknown, lpReserved, riidCmdGrp, cCmds, prgCmds, pCmdText);
2034 /* FIXME: Calls IsQSForward & IUnknown_QueryStatus */
2035 return DRAGDROP_E_NOTREGISTERED;
2038 /*************************************************************************
2039 * @ [SHLWAPI.201]
2042 HRESULT WINAPI MayExecForward(IUnknown* lpUnknown, INT iUnk, REFGUID pguidCmdGroup,
2043 DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
2044 VARIANT* pvaOut)
2046 FIXME("(%p,%d,%p,%d,%d,%p,%p) - stub!\n", lpUnknown, iUnk, pguidCmdGroup,
2047 nCmdID, nCmdexecopt, pvaIn, pvaOut);
2048 return DRAGDROP_E_NOTREGISTERED;
2051 /*************************************************************************
2052 * @ [SHLWAPI.202]
2055 HRESULT WINAPI IsQSForward(REFGUID pguidCmdGroup,ULONG cCmds, OLECMD *prgCmds)
2057 FIXME("(%p,%d,%p) - stub!\n", pguidCmdGroup, cCmds, prgCmds);
2058 return DRAGDROP_E_NOTREGISTERED;
2061 /*************************************************************************
2062 * @ [SHLWAPI.204]
2064 * Determine if a window is not a child of another window.
2066 * PARAMS
2067 * hParent [I] Suspected parent window
2068 * hChild [I] Suspected child window
2070 * RETURNS
2071 * TRUE: If hChild is a child window of hParent
2072 * FALSE: If hChild is not a child window of hParent, or they are equal
2074 BOOL WINAPI SHIsChildOrSelf(HWND hParent, HWND hChild)
2076 TRACE("(%p,%p)\n", hParent, hChild);
2078 if (!hParent || !hChild)
2079 return TRUE;
2080 else if(hParent == hChild)
2081 return FALSE;
2082 return !IsChild(hParent, hChild);
2085 /*************************************************************************
2086 * FDSA functions. Manage a dynamic array of fixed size memory blocks.
2089 typedef struct
2091 DWORD num_items; /* Number of elements inserted */
2092 void *mem; /* Ptr to array */
2093 DWORD blocks_alloced; /* Number of elements allocated */
2094 BYTE inc; /* Number of elements to grow by when we need to expand */
2095 BYTE block_size; /* Size in bytes of an element */
2096 BYTE flags; /* Flags */
2097 } FDSA_info;
2099 #define FDSA_FLAG_INTERNAL_ALLOC 0x01 /* When set we have allocated mem internally */
2101 /*************************************************************************
2102 * @ [SHLWAPI.208]
2104 * Initialize an FDSA arrary.
2106 BOOL WINAPI FDSA_Initialize(DWORD block_size, DWORD inc, FDSA_info *info, void *mem,
2107 DWORD init_blocks)
2109 TRACE("(0x%08x 0x%08x %p %p 0x%08x)\n", block_size, inc, info, mem, init_blocks);
2111 if(inc == 0)
2112 inc = 1;
2114 if(mem)
2115 memset(mem, 0, block_size * init_blocks);
2117 info->num_items = 0;
2118 info->inc = inc;
2119 info->mem = mem;
2120 info->blocks_alloced = init_blocks;
2121 info->block_size = block_size;
2122 info->flags = 0;
2124 return TRUE;
2127 /*************************************************************************
2128 * @ [SHLWAPI.209]
2130 * Destroy an FDSA array
2132 BOOL WINAPI FDSA_Destroy(FDSA_info *info)
2134 TRACE("(%p)\n", info);
2136 if(info->flags & FDSA_FLAG_INTERNAL_ALLOC)
2138 HeapFree(GetProcessHeap(), 0, info->mem);
2139 return FALSE;
2142 return TRUE;
2145 /*************************************************************************
2146 * @ [SHLWAPI.210]
2148 * Insert element into an FDSA array
2150 DWORD WINAPI FDSA_InsertItem(FDSA_info *info, DWORD where, const void *block)
2152 TRACE("(%p 0x%08x %p)\n", info, where, block);
2153 if(where > info->num_items)
2154 where = info->num_items;
2156 if(info->num_items >= info->blocks_alloced)
2158 DWORD size = (info->blocks_alloced + info->inc) * info->block_size;
2159 if(info->flags & 0x1)
2160 info->mem = HeapReAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, info->mem, size);
2161 else
2163 void *old_mem = info->mem;
2164 info->mem = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, size);
2165 memcpy(info->mem, old_mem, info->blocks_alloced * info->block_size);
2167 info->blocks_alloced += info->inc;
2168 info->flags |= 0x1;
2171 if(where < info->num_items)
2173 memmove((char*)info->mem + (where + 1) * info->block_size,
2174 (char*)info->mem + where * info->block_size,
2175 (info->num_items - where) * info->block_size);
2177 memcpy((char*)info->mem + where * info->block_size, block, info->block_size);
2179 info->num_items++;
2180 return where;
2183 /*************************************************************************
2184 * @ [SHLWAPI.211]
2186 * Delete an element from an FDSA array.
2188 BOOL WINAPI FDSA_DeleteItem(FDSA_info *info, DWORD where)
2190 TRACE("(%p 0x%08x)\n", info, where);
2192 if(where >= info->num_items)
2193 return FALSE;
2195 if(where < info->num_items - 1)
2197 memmove((char*)info->mem + where * info->block_size,
2198 (char*)info->mem + (where + 1) * info->block_size,
2199 (info->num_items - where - 1) * info->block_size);
2201 memset((char*)info->mem + (info->num_items - 1) * info->block_size,
2202 0, info->block_size);
2203 info->num_items--;
2204 return TRUE;
2208 typedef struct {
2209 REFIID refid;
2210 DWORD indx;
2211 } IFACE_INDEX_TBL;
2213 /*************************************************************************
2214 * @ [SHLWAPI.219]
2216 * Call IUnknown_QueryInterface() on a table of objects.
2218 * RETURNS
2219 * Success: S_OK.
2220 * Failure: E_POINTER or E_NOINTERFACE.
2222 HRESULT WINAPI QISearch(
2223 LPVOID w, /* [in] Table of interfaces */
2224 IFACE_INDEX_TBL *x, /* [in] Array of REFIIDs and indexes into the table */
2225 REFIID riid, /* [in] REFIID to get interface for */
2226 LPVOID *ppv) /* [out] Destination for interface pointer */
2228 HRESULT ret;
2229 IUnknown *a_vtbl;
2230 IFACE_INDEX_TBL *xmove;
2232 TRACE("(%p %p %s %p)\n", w,x,debugstr_guid(riid),ppv);
2233 if (ppv) {
2234 xmove = x;
2235 while (xmove->refid) {
2236 TRACE("trying (indx %d) %s\n", xmove->indx, debugstr_guid(xmove->refid));
2237 if (IsEqualIID(riid, xmove->refid)) {
2238 a_vtbl = (IUnknown*)(xmove->indx + (LPBYTE)w);
2239 TRACE("matched, returning (%p)\n", a_vtbl);
2240 *ppv = (LPVOID)a_vtbl;
2241 IUnknown_AddRef(a_vtbl);
2242 return S_OK;
2244 xmove++;
2247 if (IsEqualIID(riid, &IID_IUnknown)) {
2248 a_vtbl = (IUnknown*)(x->indx + (LPBYTE)w);
2249 TRACE("returning first for IUnknown (%p)\n", a_vtbl);
2250 *ppv = (LPVOID)a_vtbl;
2251 IUnknown_AddRef(a_vtbl);
2252 return S_OK;
2254 *ppv = 0;
2255 ret = E_NOINTERFACE;
2256 } else
2257 ret = E_POINTER;
2259 TRACE("-- 0x%08x\n", ret);
2260 return ret;
2263 /*************************************************************************
2264 * @ [SHLWAPI.221]
2266 * Remove the "PropDlgFont" property from a window.
2268 * PARAMS
2269 * hWnd [I] Window to remove the property from
2271 * RETURNS
2272 * A handle to the removed property, or NULL if it did not exist.
2274 HANDLE WINAPI SHRemoveDefaultDialogFont(HWND hWnd)
2276 HANDLE hProp;
2278 TRACE("(%p)\n", hWnd);
2280 hProp = GetPropA(hWnd, "PropDlgFont");
2282 if(hProp)
2284 DeleteObject(hProp);
2285 hProp = RemovePropA(hWnd, "PropDlgFont");
2287 return hProp;
2290 /*************************************************************************
2291 * @ [SHLWAPI.236]
2293 * Load the in-process server of a given GUID.
2295 * PARAMS
2296 * refiid [I] GUID of the server to load.
2298 * RETURNS
2299 * Success: A handle to the loaded server dll.
2300 * Failure: A NULL handle.
2302 HMODULE WINAPI SHPinDllOfCLSID(REFIID refiid)
2304 HKEY newkey;
2305 DWORD type, count;
2306 CHAR value[MAX_PATH], string[MAX_PATH];
2308 strcpy(string, "CLSID\\");
2309 SHStringFromGUIDA(refiid, string + 6, sizeof(string)/sizeof(char) - 6);
2310 strcat(string, "\\InProcServer32");
2312 count = MAX_PATH;
2313 RegOpenKeyExA(HKEY_CLASSES_ROOT, string, 0, 1, &newkey);
2314 RegQueryValueExA(newkey, 0, 0, &type, (PBYTE)value, &count);
2315 RegCloseKey(newkey);
2316 return LoadLibraryExA(value, 0, 0);
2319 /*************************************************************************
2320 * @ [SHLWAPI.237]
2322 * Unicode version of SHLWAPI_183.
2324 DWORD WINAPI SHRegisterClassW(WNDCLASSW * lpWndClass)
2326 WNDCLASSW WndClass;
2328 TRACE("(%p %s)\n",lpWndClass->hInstance, debugstr_w(lpWndClass->lpszClassName));
2330 if (GetClassInfoW(lpWndClass->hInstance, lpWndClass->lpszClassName, &WndClass))
2331 return TRUE;
2332 return RegisterClassW(lpWndClass);
2335 /*************************************************************************
2336 * @ [SHLWAPI.238]
2338 * Unregister a list of classes.
2340 * PARAMS
2341 * hInst [I] Application instance that registered the classes
2342 * lppClasses [I] List of class names
2343 * iCount [I] Number of names in lppClasses
2345 * RETURNS
2346 * Nothing.
2348 void WINAPI SHUnregisterClassesA(HINSTANCE hInst, LPCSTR *lppClasses, INT iCount)
2350 WNDCLASSA WndClass;
2352 TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2354 while (iCount > 0)
2356 if (GetClassInfoA(hInst, *lppClasses, &WndClass))
2357 UnregisterClassA(*lppClasses, hInst);
2358 lppClasses++;
2359 iCount--;
2363 /*************************************************************************
2364 * @ [SHLWAPI.239]
2366 * Unicode version of SHUnregisterClassesA.
2368 void WINAPI SHUnregisterClassesW(HINSTANCE hInst, LPCWSTR *lppClasses, INT iCount)
2370 WNDCLASSW WndClass;
2372 TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2374 while (iCount > 0)
2376 if (GetClassInfoW(hInst, *lppClasses, &WndClass))
2377 UnregisterClassW(*lppClasses, hInst);
2378 lppClasses++;
2379 iCount--;
2383 /*************************************************************************
2384 * @ [SHLWAPI.240]
2386 * Call The correct (Ascii/Unicode) default window procedure for a window.
2388 * PARAMS
2389 * hWnd [I] Window to call the default procedure for
2390 * uMessage [I] Message ID
2391 * wParam [I] WPARAM of message
2392 * lParam [I] LPARAM of message
2394 * RETURNS
2395 * The result of calling DefWindowProcA() or DefWindowProcW().
2397 LRESULT CALLBACK SHDefWindowProc(HWND hWnd, UINT uMessage, WPARAM wParam, LPARAM lParam)
2399 if (IsWindowUnicode(hWnd))
2400 return DefWindowProcW(hWnd, uMessage, wParam, lParam);
2401 return DefWindowProcA(hWnd, uMessage, wParam, lParam);
2404 /*************************************************************************
2405 * @ [SHLWAPI.256]
2407 HRESULT WINAPI IUnknown_GetSite(LPUNKNOWN lpUnknown, REFIID iid, PVOID *lppSite)
2409 HRESULT hRet = E_INVALIDARG;
2410 LPOBJECTWITHSITE lpSite = NULL;
2412 TRACE("(%p,%s,%p)\n", lpUnknown, debugstr_guid(iid), lppSite);
2414 if (lpUnknown && iid && lppSite)
2416 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IObjectWithSite,
2417 (void**)&lpSite);
2418 if (SUCCEEDED(hRet) && lpSite)
2420 hRet = IObjectWithSite_GetSite(lpSite, iid, lppSite);
2421 IObjectWithSite_Release(lpSite);
2424 return hRet;
2427 /*************************************************************************
2428 * @ [SHLWAPI.257]
2430 * Create a worker window using CreateWindowExA().
2432 * PARAMS
2433 * wndProc [I] Window procedure
2434 * hWndParent [I] Parent window
2435 * dwExStyle [I] Extra style flags
2436 * dwStyle [I] Style flags
2437 * hMenu [I] Window menu
2438 * z [I] Unknown
2440 * RETURNS
2441 * Success: The window handle of the newly created window.
2442 * Failure: 0.
2444 HWND WINAPI SHCreateWorkerWindowA(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2445 DWORD dwStyle, HMENU hMenu, LONG z)
2447 static const char szClass[] = "WorkerA";
2448 WNDCLASSA wc;
2449 HWND hWnd;
2451 TRACE("(0x%08x,%p,0x%08x,0x%08x,%p,0x%08x)\n",
2452 wndProc, hWndParent, dwExStyle, dwStyle, hMenu, z);
2454 /* Create Window class */
2455 wc.style = 0;
2456 wc.lpfnWndProc = DefWindowProcA;
2457 wc.cbClsExtra = 0;
2458 wc.cbWndExtra = 4;
2459 wc.hInstance = shlwapi_hInstance;
2460 wc.hIcon = NULL;
2461 wc.hCursor = LoadCursorA(NULL, (LPSTR)IDC_ARROW);
2462 wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2463 wc.lpszMenuName = NULL;
2464 wc.lpszClassName = szClass;
2466 SHRegisterClassA(&wc); /* Register class */
2468 /* FIXME: Set extra bits in dwExStyle */
2470 hWnd = CreateWindowExA(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2471 hWndParent, hMenu, shlwapi_hInstance, 0);
2472 if (hWnd)
2474 SetWindowLongPtrW(hWnd, DWLP_MSGRESULT, z);
2476 if (wndProc)
2477 SetWindowLongPtrA(hWnd, GWLP_WNDPROC, wndProc);
2479 return hWnd;
2482 typedef struct tagPOLICYDATA
2484 DWORD policy; /* flags value passed to SHRestricted */
2485 LPCWSTR appstr; /* application str such as "Explorer" */
2486 LPCWSTR keystr; /* name of the actual registry key / policy */
2487 } POLICYDATA, *LPPOLICYDATA;
2489 #define SHELL_NO_POLICY 0xffffffff
2491 /* default shell policy registry key */
2492 static const WCHAR strRegistryPolicyW[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o',
2493 's','o','f','t','\\','W','i','n','d','o','w','s','\\',
2494 'C','u','r','r','e','n','t','V','e','r','s','i','o','n',
2495 '\\','P','o','l','i','c','i','e','s',0};
2497 /*************************************************************************
2498 * @ [SHLWAPI.271]
2500 * Retrieve a policy value from the registry.
2502 * PARAMS
2503 * lpSubKey [I] registry key name
2504 * lpSubName [I] subname of registry key
2505 * lpValue [I] value name of registry value
2507 * RETURNS
2508 * the value associated with the registry key or 0 if not found
2510 DWORD WINAPI SHGetRestriction(LPCWSTR lpSubKey, LPCWSTR lpSubName, LPCWSTR lpValue)
2512 DWORD retval, datsize = sizeof(retval);
2513 HKEY hKey;
2515 if (!lpSubKey)
2516 lpSubKey = strRegistryPolicyW;
2518 retval = RegOpenKeyW(HKEY_LOCAL_MACHINE, lpSubKey, &hKey);
2519 if (retval != ERROR_SUCCESS)
2520 retval = RegOpenKeyW(HKEY_CURRENT_USER, lpSubKey, &hKey);
2521 if (retval != ERROR_SUCCESS)
2522 return 0;
2524 SHGetValueW(hKey, lpSubName, lpValue, NULL, (LPBYTE)&retval, &datsize);
2525 RegCloseKey(hKey);
2526 return retval;
2529 /*************************************************************************
2530 * @ [SHLWAPI.266]
2532 * Helper function to retrieve the possibly cached value for a specific policy
2534 * PARAMS
2535 * policy [I] The policy to look for
2536 * initial [I] Main registry key to open, if NULL use default
2537 * polTable [I] Table of known policies, 0 terminated
2538 * polArr [I] Cache array of policy values
2540 * RETURNS
2541 * The retrieved policy value or 0 if not successful
2543 * NOTES
2544 * This function is used by the native SHRestricted function to search for the
2545 * policy and cache it once retrieved. The current Wine implementation uses a
2546 * different POLICYDATA structure and implements a similar algorithme adapted to
2547 * that structure.
2549 DWORD WINAPI SHRestrictionLookup(
2550 DWORD policy,
2551 LPCWSTR initial,
2552 LPPOLICYDATA polTable,
2553 LPDWORD polArr)
2555 TRACE("(0x%08x %s %p %p)\n", policy, debugstr_w(initial), polTable, polArr);
2557 if (!polTable || !polArr)
2558 return 0;
2560 for (;polTable->policy; polTable++, polArr++)
2562 if (policy == polTable->policy)
2564 /* we have a known policy */
2566 /* check if this policy has been cached */
2567 if (*polArr == SHELL_NO_POLICY)
2568 *polArr = SHGetRestriction(initial, polTable->appstr, polTable->keystr);
2569 return *polArr;
2572 /* we don't know this policy, return 0 */
2573 TRACE("unknown policy: (%08x)\n", policy);
2574 return 0;
2577 /*************************************************************************
2578 * @ [SHLWAPI.267]
2580 * Get an interface from an object.
2582 * RETURNS
2583 * Success: S_OK. ppv contains the requested interface.
2584 * Failure: An HRESULT error code.
2586 * NOTES
2587 * This QueryInterface asks the inner object for an interface. In case
2588 * of aggregation this request would be forwarded by the inner to the
2589 * outer object. This function asks the inner object directly for the
2590 * interface circumventing the forwarding to the outer object.
2592 HRESULT WINAPI SHWeakQueryInterface(
2593 IUnknown * pUnk, /* [in] Outer object */
2594 IUnknown * pInner, /* [in] Inner object */
2595 IID * riid, /* [in] Interface GUID to query for */
2596 LPVOID* ppv) /* [out] Destination for queried interface */
2598 HRESULT hret = E_NOINTERFACE;
2599 TRACE("(pUnk=%p pInner=%p\n\tIID: %s %p)\n",pUnk,pInner,debugstr_guid(riid), ppv);
2601 *ppv = NULL;
2602 if(pUnk && pInner) {
2603 hret = IUnknown_QueryInterface(pInner, riid, (LPVOID*)ppv);
2604 if (SUCCEEDED(hret)) IUnknown_Release(pUnk);
2606 TRACE("-- 0x%08x\n", hret);
2607 return hret;
2610 /*************************************************************************
2611 * @ [SHLWAPI.268]
2613 * Move a reference from one interface to another.
2615 * PARAMS
2616 * lpDest [O] Destination to receive the reference
2617 * lppUnknown [O] Source to give up the reference to lpDest
2619 * RETURNS
2620 * Nothing.
2622 VOID WINAPI SHWeakReleaseInterface(IUnknown *lpDest, IUnknown **lppUnknown)
2624 TRACE("(%p,%p)\n", lpDest, lppUnknown);
2626 if (*lppUnknown)
2628 /* Copy Reference*/
2629 IUnknown_AddRef(lpDest);
2630 IUnknown_AtomicRelease(lppUnknown); /* Release existing interface */
2634 /*************************************************************************
2635 * @ [SHLWAPI.269]
2637 * Convert an ASCII string of a CLSID into a CLSID.
2639 * PARAMS
2640 * idstr [I] String representing a CLSID in registry format
2641 * id [O] Destination for the converted CLSID
2643 * RETURNS
2644 * Success: TRUE. id contains the converted CLSID.
2645 * Failure: FALSE.
2647 BOOL WINAPI GUIDFromStringA(LPCSTR idstr, CLSID *id)
2649 WCHAR wClsid[40];
2650 MultiByteToWideChar(CP_ACP, 0, idstr, -1, wClsid, sizeof(wClsid)/sizeof(WCHAR));
2651 return SUCCEEDED(CLSIDFromString(wClsid, id));
2654 /*************************************************************************
2655 * @ [SHLWAPI.270]
2657 * Unicode version of GUIDFromStringA.
2659 BOOL WINAPI GUIDFromStringW(LPCWSTR idstr, CLSID *id)
2661 return SUCCEEDED(CLSIDFromString((LPOLESTR)idstr, id));
2664 /*************************************************************************
2665 * @ [SHLWAPI.276]
2667 * Determine if the browser is integrated into the shell, and set a registry
2668 * key accordingly.
2670 * PARAMS
2671 * None.
2673 * RETURNS
2674 * 1, If the browser is not integrated.
2675 * 2, If the browser is integrated.
2677 * NOTES
2678 * The key "HKLM\Software\Microsoft\Internet Explorer\IntegratedBrowser" is
2679 * either set to TRUE, or removed depending on whether the browser is deemed
2680 * to be integrated.
2682 DWORD WINAPI WhichPlatform(void)
2684 static const char szIntegratedBrowser[] = "IntegratedBrowser";
2685 static DWORD dwState = 0;
2686 HKEY hKey;
2687 DWORD dwRet, dwData, dwSize;
2688 HMODULE hshell32;
2690 if (dwState)
2691 return dwState;
2693 /* If shell32 exports DllGetVersion(), the browser is integrated */
2694 dwState = 1;
2695 hshell32 = LoadLibraryA("shell32.dll");
2696 if (hshell32)
2698 FARPROC pDllGetVersion;
2699 pDllGetVersion = GetProcAddress(hshell32, "DllGetVersion");
2700 dwState = pDllGetVersion ? 2 : 1;
2701 FreeLibrary(hshell32);
2704 /* Set or delete the key accordingly */
2705 dwRet = RegOpenKeyExA(HKEY_LOCAL_MACHINE,
2706 "Software\\Microsoft\\Internet Explorer", 0,
2707 KEY_ALL_ACCESS, &hKey);
2708 if (!dwRet)
2710 dwRet = RegQueryValueExA(hKey, szIntegratedBrowser, 0, 0,
2711 (LPBYTE)&dwData, &dwSize);
2713 if (!dwRet && dwState == 1)
2715 /* Value exists but browser is not integrated */
2716 RegDeleteValueA(hKey, szIntegratedBrowser);
2718 else if (dwRet && dwState == 2)
2720 /* Browser is integrated but value does not exist */
2721 dwData = TRUE;
2722 RegSetValueExA(hKey, szIntegratedBrowser, 0, REG_DWORD,
2723 (LPBYTE)&dwData, sizeof(dwData));
2725 RegCloseKey(hKey);
2727 return dwState;
2730 /*************************************************************************
2731 * @ [SHLWAPI.278]
2733 * Unicode version of SHCreateWorkerWindowA.
2735 HWND WINAPI SHCreateWorkerWindowW(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2736 DWORD dwStyle, HMENU hMenu, LONG z)
2738 static const WCHAR szClass[] = { 'W', 'o', 'r', 'k', 'e', 'r', 'W', '\0' };
2739 WNDCLASSW wc;
2740 HWND hWnd;
2742 TRACE("(0x%08x,%p,0x%08x,0x%08x,%p,0x%08x)\n",
2743 wndProc, hWndParent, dwExStyle, dwStyle, hMenu, z);
2745 /* If our OS is natively ASCII, use the ASCII version */
2746 if (!(GetVersion() & 0x80000000)) /* NT */
2747 return SHCreateWorkerWindowA(wndProc, hWndParent, dwExStyle, dwStyle, hMenu, z);
2749 /* Create Window class */
2750 wc.style = 0;
2751 wc.lpfnWndProc = DefWindowProcW;
2752 wc.cbClsExtra = 0;
2753 wc.cbWndExtra = 4;
2754 wc.hInstance = shlwapi_hInstance;
2755 wc.hIcon = NULL;
2756 wc.hCursor = LoadCursorW(NULL, (LPWSTR)IDC_ARROW);
2757 wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2758 wc.lpszMenuName = NULL;
2759 wc.lpszClassName = szClass;
2761 SHRegisterClassW(&wc); /* Register class */
2763 /* FIXME: Set extra bits in dwExStyle */
2765 hWnd = CreateWindowExW(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2766 hWndParent, hMenu, shlwapi_hInstance, 0);
2767 if (hWnd)
2769 SetWindowLongPtrW(hWnd, DWLP_MSGRESULT, z);
2771 if (wndProc)
2772 SetWindowLongPtrW(hWnd, GWLP_WNDPROC, wndProc);
2774 return hWnd;
2777 /*************************************************************************
2778 * @ [SHLWAPI.279]
2780 * Get and show a context menu from a shell folder.
2782 * PARAMS
2783 * hWnd [I] Window displaying the shell folder
2784 * lpFolder [I] IShellFolder interface
2785 * lpApidl [I] Id for the particular folder desired
2787 * RETURNS
2788 * Success: S_OK.
2789 * Failure: An HRESULT error code indicating the error.
2791 HRESULT WINAPI SHInvokeDefaultCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl)
2793 return SHInvokeCommand(hWnd, lpFolder, lpApidl, FALSE);
2796 /*************************************************************************
2797 * @ [SHLWAPI.281]
2799 * _SHPackDispParamsV
2801 HRESULT WINAPI SHPackDispParamsV(DISPPARAMS *params, VARIANTARG *args, UINT cnt, va_list valist)
2803 VARIANTARG *iter;
2805 TRACE("(%p %p %u ...)\n", params, args, cnt);
2807 params->rgvarg = args;
2808 params->rgdispidNamedArgs = NULL;
2809 params->cArgs = cnt;
2810 params->cNamedArgs = 0;
2812 iter = args+cnt;
2814 while(iter-- > args) {
2815 V_VT(iter) = va_arg(valist, enum VARENUM);
2817 TRACE("vt=%d\n", V_VT(iter));
2819 if(V_VT(iter) & VT_BYREF) {
2820 V_BYREF(iter) = va_arg(valist, LPVOID);
2821 } else {
2822 switch(V_VT(iter)) {
2823 case VT_I4:
2824 V_I4(iter) = va_arg(valist, LONG);
2825 break;
2826 case VT_BSTR:
2827 V_BSTR(iter) = va_arg(valist, BSTR);
2828 break;
2829 case VT_DISPATCH:
2830 V_DISPATCH(iter) = va_arg(valist, IDispatch*);
2831 break;
2832 case VT_BOOL:
2833 V_BOOL(iter) = va_arg(valist, int);
2834 break;
2835 case VT_UNKNOWN:
2836 V_UNKNOWN(iter) = va_arg(valist, IUnknown*);
2837 break;
2838 default:
2839 V_VT(iter) = VT_I4;
2840 V_I4(iter) = va_arg(valist, LONG);
2845 return S_OK;
2848 /*************************************************************************
2849 * @ [SHLWAPI.282]
2851 * SHPackDispParams
2853 HRESULT WINAPIV SHPackDispParams(DISPPARAMS *params, VARIANTARG *args, UINT cnt, ...)
2855 va_list valist;
2856 HRESULT hres;
2858 va_start(valist, cnt);
2860 hres = SHPackDispParamsV(params, args, cnt, valist);
2862 va_end(valist);
2863 return hres;
2866 /*************************************************************************
2867 * SHLWAPI_InvokeByIID
2869 * This helper function calls IDispatch::Invoke for each sink
2870 * which implements given iid or IDispatch.
2873 static HRESULT SHLWAPI_InvokeByIID(
2874 IConnectionPoint* iCP,
2875 REFIID iid,
2876 DISPID dispId,
2877 DISPPARAMS* dispParams)
2879 IEnumConnections *enumerator;
2880 CONNECTDATA rgcd;
2882 HRESULT result = IConnectionPoint_EnumConnections(iCP, &enumerator);
2883 if (FAILED(result))
2884 return result;
2886 while(IEnumConnections_Next(enumerator, 1, &rgcd, NULL)==S_OK)
2888 IDispatch *dispIface;
2889 if (SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, iid, (LPVOID*)&dispIface)) ||
2890 SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, &IID_IDispatch, (LPVOID*)&dispIface)))
2892 IDispatch_Invoke(dispIface, dispId, &IID_NULL, 0, DISPATCH_METHOD, dispParams, NULL, NULL, NULL);
2893 IDispatch_Release(dispIface);
2897 IEnumConnections_Release(enumerator);
2899 return S_OK;
2902 /*************************************************************************
2903 * @ [SHLWAPI.284]
2905 * IConnectionPoint_SimpleInvoke
2907 HRESULT WINAPI IConnectionPoint_SimpleInvoke(
2908 IConnectionPoint* iCP,
2909 DISPID dispId,
2910 DISPPARAMS* dispParams)
2912 IID iid;
2913 HRESULT result;
2915 TRACE("(%p)->(0x%x %p)\n",iCP,dispId,dispParams);
2917 result = IConnectionPoint_GetConnectionInterface(iCP, &iid);
2918 if (SUCCEEDED(result))
2919 result = SHLWAPI_InvokeByIID(iCP, &iid, dispId, dispParams);
2921 return result;
2924 /*************************************************************************
2925 * @ [SHLWAPI.285]
2927 * Notify an IConnectionPoint object of changes.
2929 * PARAMS
2930 * lpCP [I] Object to notify
2931 * dispID [I]
2933 * RETURNS
2934 * Success: S_OK.
2935 * Failure: E_NOINTERFACE, if lpCP is NULL or does not support the
2936 * IConnectionPoint interface.
2938 HRESULT WINAPI IConnectionPoint_OnChanged(IConnectionPoint* lpCP, DISPID dispID)
2940 IEnumConnections *lpEnum;
2941 HRESULT hRet = E_NOINTERFACE;
2943 TRACE("(%p,0x%8X)\n", lpCP, dispID);
2945 /* Get an enumerator for the connections */
2946 if (lpCP)
2947 hRet = IConnectionPoint_EnumConnections(lpCP, &lpEnum);
2949 if (SUCCEEDED(hRet))
2951 IPropertyNotifySink *lpSink;
2952 CONNECTDATA connData;
2953 ULONG ulFetched;
2955 /* Call OnChanged() for every notify sink in the connection point */
2956 while (IEnumConnections_Next(lpEnum, 1, &connData, &ulFetched) == S_OK)
2958 if (SUCCEEDED(IUnknown_QueryInterface(connData.pUnk, &IID_IPropertyNotifySink, (void**)&lpSink)) &&
2959 lpSink)
2961 IPropertyNotifySink_OnChanged(lpSink, dispID);
2962 IPropertyNotifySink_Release(lpSink);
2964 IUnknown_Release(connData.pUnk);
2967 IEnumConnections_Release(lpEnum);
2969 return hRet;
2972 /*************************************************************************
2973 * @ [SHLWAPI.286]
2975 * IUnknown_CPContainerInvokeParam
2977 HRESULT WINAPIV IUnknown_CPContainerInvokeParam(
2978 IUnknown *container,
2979 REFIID riid,
2980 DISPID dispId,
2981 VARIANTARG* buffer,
2982 DWORD cParams, ...)
2984 HRESULT result;
2985 IConnectionPoint *iCP;
2986 IConnectionPointContainer *iCPC;
2987 DISPPARAMS dispParams = {buffer, NULL, cParams, 0};
2988 va_list valist;
2990 if (!container)
2991 return E_NOINTERFACE;
2993 result = IUnknown_QueryInterface(container, &IID_IConnectionPointContainer,(LPVOID*) &iCPC);
2994 if (FAILED(result))
2995 return result;
2997 result = IConnectionPointContainer_FindConnectionPoint(iCPC, riid, &iCP);
2998 IConnectionPointContainer_Release(iCPC);
2999 if(FAILED(result))
3000 return result;
3002 va_start(valist, cParams);
3003 SHPackDispParamsV(&dispParams, buffer, cParams, valist);
3004 va_end(valist);
3006 result = SHLWAPI_InvokeByIID(iCP, riid, dispId, &dispParams);
3007 IConnectionPoint_Release(iCP);
3009 return result;
3012 /*************************************************************************
3013 * @ [SHLWAPI.287]
3015 * Notify an IConnectionPointContainer object of changes.
3017 * PARAMS
3018 * lpUnknown [I] Object to notify
3019 * dispID [I]
3021 * RETURNS
3022 * Success: S_OK.
3023 * Failure: E_NOINTERFACE, if lpUnknown is NULL or does not support the
3024 * IConnectionPointContainer interface.
3026 HRESULT WINAPI IUnknown_CPContainerOnChanged(IUnknown *lpUnknown, DISPID dispID)
3028 IConnectionPointContainer* lpCPC = NULL;
3029 HRESULT hRet = E_NOINTERFACE;
3031 TRACE("(%p,0x%8X)\n", lpUnknown, dispID);
3033 if (lpUnknown)
3034 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer, (void**)&lpCPC);
3036 if (SUCCEEDED(hRet))
3038 IConnectionPoint* lpCP;
3040 hRet = IConnectionPointContainer_FindConnectionPoint(lpCPC, &IID_IPropertyNotifySink, &lpCP);
3041 IConnectionPointContainer_Release(lpCPC);
3043 hRet = IConnectionPoint_OnChanged(lpCP, dispID);
3044 IConnectionPoint_Release(lpCP);
3046 return hRet;
3049 /*************************************************************************
3050 * @ [SHLWAPI.289]
3052 * See PlaySoundW.
3054 BOOL WINAPI PlaySoundWrapW(LPCWSTR pszSound, HMODULE hmod, DWORD fdwSound)
3056 return PlaySoundW(pszSound, hmod, fdwSound);
3059 /*************************************************************************
3060 * @ [SHLWAPI.294]
3062 BOOL WINAPI SHGetIniStringW(LPCWSTR str1, LPCWSTR str2, LPWSTR pStr, DWORD some_len, LPCWSTR lpStr2)
3064 FIXME("(%s,%s,%p,%08x,%s): stub!\n", debugstr_w(str1), debugstr_w(str2),
3065 pStr, some_len, debugstr_w(lpStr2));
3066 return TRUE;
3069 /*************************************************************************
3070 * @ [SHLWAPI.295]
3072 * Called by ICQ2000b install via SHDOCVW:
3073 * str1: "InternetShortcut"
3074 * x: some unknown pointer
3075 * str2: "http://free.aol.com/tryaolfree/index.adp?139269"
3076 * str3: "C:\\WINDOWS\\Desktop.new2\\Free AOL & Unlimited Internet.url"
3078 * In short: this one maybe creates a desktop link :-)
3080 BOOL WINAPI SHSetIniStringW(LPWSTR str1, LPVOID x, LPWSTR str2, LPWSTR str3)
3082 FIXME("(%s, %p, %s, %s), stub.\n", debugstr_w(str1), x, debugstr_w(str2), debugstr_w(str3));
3083 return TRUE;
3086 /*************************************************************************
3087 * @ [SHLWAPI.313]
3089 * See SHGetFileInfoW.
3091 DWORD WINAPI SHGetFileInfoWrapW(LPCWSTR path, DWORD dwFileAttributes,
3092 SHFILEINFOW *psfi, UINT sizeofpsfi, UINT flags)
3094 return SHGetFileInfoW(path, dwFileAttributes, psfi, sizeofpsfi, flags);
3097 /*************************************************************************
3098 * @ [SHLWAPI.318]
3100 * See DragQueryFileW.
3102 UINT WINAPI DragQueryFileWrapW(HDROP hDrop, UINT lFile, LPWSTR lpszFile, UINT lLength)
3104 return DragQueryFileW(hDrop, lFile, lpszFile, lLength);
3107 /*************************************************************************
3108 * @ [SHLWAPI.333]
3110 * See SHBrowseForFolderW.
3112 LPITEMIDLIST WINAPI SHBrowseForFolderWrapW(LPBROWSEINFOW lpBi)
3114 return SHBrowseForFolderW(lpBi);
3117 /*************************************************************************
3118 * @ [SHLWAPI.334]
3120 * See SHGetPathFromIDListW.
3122 BOOL WINAPI SHGetPathFromIDListWrapW(LPCITEMIDLIST pidl,LPWSTR pszPath)
3124 return SHGetPathFromIDListW(pidl, pszPath);
3127 /*************************************************************************
3128 * @ [SHLWAPI.335]
3130 * See ShellExecuteExW.
3132 BOOL WINAPI ShellExecuteExWrapW(LPSHELLEXECUTEINFOW lpExecInfo)
3134 return ShellExecuteExW(lpExecInfo);
3137 /*************************************************************************
3138 * @ [SHLWAPI.336]
3140 * See SHFileOperationW.
3142 INT WINAPI SHFileOperationWrapW(LPSHFILEOPSTRUCTW lpFileOp)
3144 return SHFileOperationW(lpFileOp);
3147 /*************************************************************************
3148 * @ [SHLWAPI.342]
3151 PVOID WINAPI SHInterlockedCompareExchange( PVOID *dest, PVOID xchg, PVOID compare )
3153 return InterlockedCompareExchangePointer( dest, xchg, compare );
3156 /*************************************************************************
3157 * @ [SHLWAPI.350]
3159 * See GetFileVersionInfoSizeW.
3161 DWORD WINAPI GetFileVersionInfoSizeWrapW( LPCWSTR filename, LPDWORD handle )
3163 return GetFileVersionInfoSizeW( filename, handle );
3166 /*************************************************************************
3167 * @ [SHLWAPI.351]
3169 * See GetFileVersionInfoW.
3171 BOOL WINAPI GetFileVersionInfoWrapW( LPCWSTR filename, DWORD handle,
3172 DWORD datasize, LPVOID data )
3174 return GetFileVersionInfoW( filename, handle, datasize, data );
3177 /*************************************************************************
3178 * @ [SHLWAPI.352]
3180 * See VerQueryValueW.
3182 WORD WINAPI VerQueryValueWrapW( LPVOID pBlock, LPCWSTR lpSubBlock,
3183 LPVOID *lplpBuffer, UINT *puLen )
3185 return VerQueryValueW( pBlock, lpSubBlock, lplpBuffer, puLen );
3188 #define IsIface(type) SUCCEEDED((hRet = IUnknown_QueryInterface(lpUnknown, &IID_##type, (void**)&lpObj)))
3189 #define IShellBrowser_EnableModeless IShellBrowser_EnableModelessSB
3190 #define EnableModeless(type) type##_EnableModeless((type*)lpObj, bModeless)
3192 /*************************************************************************
3193 * @ [SHLWAPI.355]
3195 * Change the modality of a shell object.
3197 * PARAMS
3198 * lpUnknown [I] Object to make modeless
3199 * bModeless [I] TRUE=Make modeless, FALSE=Make modal
3201 * RETURNS
3202 * Success: S_OK. The modality lpUnknown is changed.
3203 * Failure: An HRESULT error code indicating the error.
3205 * NOTES
3206 * lpUnknown must support the IOleInPlaceFrame interface, the
3207 * IInternetSecurityMgrSite interface, the IShellBrowser interface
3208 * the IDocHostUIHandler interface, or the IOleInPlaceActiveObject interface,
3209 * or this call will fail.
3211 HRESULT WINAPI IUnknown_EnableModeless(IUnknown *lpUnknown, BOOL bModeless)
3213 IUnknown *lpObj;
3214 HRESULT hRet;
3216 TRACE("(%p,%d)\n", lpUnknown, bModeless);
3218 if (!lpUnknown)
3219 return E_FAIL;
3221 if (IsIface(IOleInPlaceActiveObject))
3222 EnableModeless(IOleInPlaceActiveObject);
3223 else if (IsIface(IOleInPlaceFrame))
3224 EnableModeless(IOleInPlaceFrame);
3225 else if (IsIface(IShellBrowser))
3226 EnableModeless(IShellBrowser);
3227 else if (IsIface(IInternetSecurityMgrSite))
3228 EnableModeless(IInternetSecurityMgrSite);
3229 else if (IsIface(IDocHostUIHandler))
3230 EnableModeless(IDocHostUIHandler);
3231 else
3232 return hRet;
3234 IUnknown_Release(lpObj);
3235 return S_OK;
3238 /*************************************************************************
3239 * @ [SHLWAPI.357]
3241 * See SHGetNewLinkInfoW.
3243 BOOL WINAPI SHGetNewLinkInfoWrapW(LPCWSTR pszLinkTo, LPCWSTR pszDir, LPWSTR pszName,
3244 BOOL *pfMustCopy, UINT uFlags)
3246 return SHGetNewLinkInfoW(pszLinkTo, pszDir, pszName, pfMustCopy, uFlags);
3249 /*************************************************************************
3250 * @ [SHLWAPI.358]
3252 * See SHDefExtractIconW.
3254 UINT WINAPI SHDefExtractIconWrapW(LPCWSTR pszIconFile, int iIndex, UINT uFlags, HICON* phiconLarge,
3255 HICON* phiconSmall, UINT nIconSize)
3257 return SHDefExtractIconW(pszIconFile, iIndex, uFlags, phiconLarge, phiconSmall, nIconSize);
3260 /*************************************************************************
3261 * @ [SHLWAPI.363]
3263 * Get and show a context menu from a shell folder.
3265 * PARAMS
3266 * hWnd [I] Window displaying the shell folder
3267 * lpFolder [I] IShellFolder interface
3268 * lpApidl [I] Id for the particular folder desired
3269 * bInvokeDefault [I] Whether to invoke the default menu item
3271 * RETURNS
3272 * Success: S_OK. If bInvokeDefault is TRUE, the default menu action was
3273 * executed.
3274 * Failure: An HRESULT error code indicating the error.
3276 HRESULT WINAPI SHInvokeCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl, BOOL bInvokeDefault)
3278 IContextMenu *iContext;
3279 HRESULT hRet = E_FAIL;
3281 TRACE("(%p,%p,%p,%d)\n", hWnd, lpFolder, lpApidl, bInvokeDefault);
3283 if (!lpFolder)
3284 return hRet;
3286 /* Get the context menu from the shell folder */
3287 hRet = IShellFolder_GetUIObjectOf(lpFolder, hWnd, 1, &lpApidl,
3288 &IID_IContextMenu, 0, (void**)&iContext);
3289 if (SUCCEEDED(hRet))
3291 HMENU hMenu;
3292 if ((hMenu = CreatePopupMenu()))
3294 HRESULT hQuery;
3295 DWORD dwDefaultId = 0;
3297 /* Add the context menu entries to the popup */
3298 hQuery = IContextMenu_QueryContextMenu(iContext, hMenu, 0, 1, 0x7FFF,
3299 bInvokeDefault ? CMF_NORMAL : CMF_DEFAULTONLY);
3301 if (SUCCEEDED(hQuery))
3303 if (bInvokeDefault &&
3304 (dwDefaultId = GetMenuDefaultItem(hMenu, 0, 0)) != 0xFFFFFFFF)
3306 CMINVOKECOMMANDINFO cmIci;
3307 /* Invoke the default item */
3308 memset(&cmIci,0,sizeof(cmIci));
3309 cmIci.cbSize = sizeof(cmIci);
3310 cmIci.fMask = CMIC_MASK_ASYNCOK;
3311 cmIci.hwnd = hWnd;
3312 cmIci.lpVerb = MAKEINTRESOURCEA(dwDefaultId);
3313 cmIci.nShow = SW_SCROLLCHILDREN;
3315 hRet = IContextMenu_InvokeCommand(iContext, &cmIci);
3318 DestroyMenu(hMenu);
3320 IContextMenu_Release(iContext);
3322 return hRet;
3325 /*************************************************************************
3326 * @ [SHLWAPI.370]
3328 * See ExtractIconW.
3330 HICON WINAPI ExtractIconWrapW(HINSTANCE hInstance, LPCWSTR lpszExeFileName,
3331 UINT nIconIndex)
3333 return ExtractIconW(hInstance, lpszExeFileName, nIconIndex);
3336 /*************************************************************************
3337 * @ [SHLWAPI.377]
3339 * Load a library from the directory of a particular process.
3341 * PARAMS
3342 * new_mod [I] Library name
3343 * inst_hwnd [I] Module whose directory is to be used
3344 * dwCrossCodePage [I] Should be FALSE (currently ignored)
3346 * RETURNS
3347 * Success: A handle to the loaded module
3348 * Failure: A NULL handle.
3350 HMODULE WINAPI MLLoadLibraryA(LPCSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3352 /* FIXME: Native appears to do DPA_Create and a DPA_InsertPtr for
3353 * each call here.
3354 * FIXME: Native shows calls to:
3355 * SHRegGetUSValue for "Software\Microsoft\Internet Explorer\International"
3356 * CheckVersion
3357 * RegOpenKeyExA for "HKLM\Software\Microsoft\Internet Explorer"
3358 * RegQueryValueExA for "LPKInstalled"
3359 * RegCloseKey
3360 * RegOpenKeyExA for "HKCU\Software\Microsoft\Internet Explorer\International"
3361 * RegQueryValueExA for "ResourceLocale"
3362 * RegCloseKey
3363 * RegOpenKeyExA for "HKLM\Software\Microsoft\Active Setup\Installed Components\{guid}"
3364 * RegQueryValueExA for "Locale"
3365 * RegCloseKey
3366 * and then tests the Locale ("en" for me).
3367 * code below
3368 * after the code then a DPA_Create (first time) and DPA_InsertPtr are done.
3370 CHAR mod_path[2*MAX_PATH];
3371 LPSTR ptr;
3372 DWORD len;
3374 FIXME("(%s,%p,%d) semi-stub!\n", debugstr_a(new_mod), inst_hwnd, dwCrossCodePage);
3375 len = GetModuleFileNameA(inst_hwnd, mod_path, sizeof(mod_path));
3376 if (!len || len >= sizeof(mod_path)) return NULL;
3378 ptr = strrchr(mod_path, '\\');
3379 if (ptr) {
3380 strcpy(ptr+1, new_mod);
3381 TRACE("loading %s\n", debugstr_a(mod_path));
3382 return LoadLibraryA(mod_path);
3384 return NULL;
3387 /*************************************************************************
3388 * @ [SHLWAPI.378]
3390 * Unicode version of MLLoadLibraryA.
3392 HMODULE WINAPI MLLoadLibraryW(LPCWSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3394 WCHAR mod_path[2*MAX_PATH];
3395 LPWSTR ptr;
3396 DWORD len;
3398 FIXME("(%s,%p,%d) semi-stub!\n", debugstr_w(new_mod), inst_hwnd, dwCrossCodePage);
3399 len = GetModuleFileNameW(inst_hwnd, mod_path, sizeof(mod_path) / sizeof(WCHAR));
3400 if (!len || len >= sizeof(mod_path) / sizeof(WCHAR)) return NULL;
3402 ptr = strrchrW(mod_path, '\\');
3403 if (ptr) {
3404 strcpyW(ptr+1, new_mod);
3405 TRACE("loading %s\n", debugstr_w(mod_path));
3406 return LoadLibraryW(mod_path);
3408 return NULL;
3411 /*************************************************************************
3412 * ColorAdjustLuma [SHLWAPI.@]
3414 * Adjust the luminosity of a color
3416 * PARAMS
3417 * cRGB [I] RGB value to convert
3418 * dwLuma [I] Luma adjustment
3419 * bUnknown [I] Unknown
3421 * RETURNS
3422 * The adjusted RGB color.
3424 COLORREF WINAPI ColorAdjustLuma(COLORREF cRGB, int dwLuma, BOOL bUnknown)
3426 TRACE("(0x%8x,%d,%d)\n", cRGB, dwLuma, bUnknown);
3428 if (dwLuma)
3430 WORD wH, wL, wS;
3432 ColorRGBToHLS(cRGB, &wH, &wL, &wS);
3434 FIXME("Ignoring luma adjustment\n");
3436 /* FIXME: The ajdustment is not linear */
3438 cRGB = ColorHLSToRGB(wH, wL, wS);
3440 return cRGB;
3443 /*************************************************************************
3444 * @ [SHLWAPI.389]
3446 * See GetSaveFileNameW.
3448 BOOL WINAPI GetSaveFileNameWrapW(LPOPENFILENAMEW ofn)
3450 return GetSaveFileNameW(ofn);
3453 /*************************************************************************
3454 * @ [SHLWAPI.390]
3456 * See WNetRestoreConnectionW.
3458 DWORD WINAPI WNetRestoreConnectionWrapW(HWND hwndOwner, LPWSTR lpszDevice)
3460 return WNetRestoreConnectionW(hwndOwner, lpszDevice);
3463 /*************************************************************************
3464 * @ [SHLWAPI.391]
3466 * See WNetGetLastErrorW.
3468 DWORD WINAPI WNetGetLastErrorWrapW(LPDWORD lpError, LPWSTR lpErrorBuf, DWORD nErrorBufSize,
3469 LPWSTR lpNameBuf, DWORD nNameBufSize)
3471 return WNetGetLastErrorW(lpError, lpErrorBuf, nErrorBufSize, lpNameBuf, nNameBufSize);
3474 /*************************************************************************
3475 * @ [SHLWAPI.401]
3477 * See PageSetupDlgW.
3479 BOOL WINAPI PageSetupDlgWrapW(LPPAGESETUPDLGW pagedlg)
3481 return PageSetupDlgW(pagedlg);
3484 /*************************************************************************
3485 * @ [SHLWAPI.402]
3487 * See PrintDlgW.
3489 BOOL WINAPI PrintDlgWrapW(LPPRINTDLGW printdlg)
3491 return PrintDlgW(printdlg);
3494 /*************************************************************************
3495 * @ [SHLWAPI.403]
3497 * See GetOpenFileNameW.
3499 BOOL WINAPI GetOpenFileNameWrapW(LPOPENFILENAMEW ofn)
3501 return GetOpenFileNameW(ofn);
3504 /*************************************************************************
3505 * @ [SHLWAPI.404]
3507 HRESULT WINAPI SHIShellFolder_EnumObjects(LPSHELLFOLDER lpFolder, HWND hwnd, SHCONTF flags, IEnumIDList **ppenum)
3509 IPersist *persist;
3510 HRESULT hr;
3512 hr = IShellFolder_QueryInterface(lpFolder, &IID_IPersist, (LPVOID)&persist);
3513 if(SUCCEEDED(hr))
3515 CLSID clsid;
3516 hr = IPersist_GetClassID(persist, &clsid);
3517 if(SUCCEEDED(hr))
3519 if(IsEqualCLSID(&clsid, &CLSID_ShellFSFolder))
3520 hr = IShellFolder_EnumObjects(lpFolder, hwnd, flags, ppenum);
3521 else
3522 hr = E_FAIL;
3524 IPersist_Release(persist);
3526 return hr;
3529 /* INTERNAL: Map from HLS color space to RGB */
3530 static WORD WINAPI ConvertHue(int wHue, WORD wMid1, WORD wMid2)
3532 wHue = wHue > 240 ? wHue - 240 : wHue < 0 ? wHue + 240 : wHue;
3534 if (wHue > 160)
3535 return wMid1;
3536 else if (wHue > 120)
3537 wHue = 160 - wHue;
3538 else if (wHue > 40)
3539 return wMid2;
3541 return ((wHue * (wMid2 - wMid1) + 20) / 40) + wMid1;
3544 /* Convert to RGB and scale into RGB range (0..255) */
3545 #define GET_RGB(h) (ConvertHue(h, wMid1, wMid2) * 255 + 120) / 240
3547 /*************************************************************************
3548 * ColorHLSToRGB [SHLWAPI.@]
3550 * Convert from hls color space into an rgb COLORREF.
3552 * PARAMS
3553 * wHue [I] Hue amount
3554 * wLuminosity [I] Luminosity amount
3555 * wSaturation [I] Saturation amount
3557 * RETURNS
3558 * A COLORREF representing the converted color.
3560 * NOTES
3561 * Input hls values are constrained to the range (0..240).
3563 COLORREF WINAPI ColorHLSToRGB(WORD wHue, WORD wLuminosity, WORD wSaturation)
3565 WORD wRed;
3567 if (wSaturation)
3569 WORD wGreen, wBlue, wMid1, wMid2;
3571 if (wLuminosity > 120)
3572 wMid2 = wSaturation + wLuminosity - (wSaturation * wLuminosity + 120) / 240;
3573 else
3574 wMid2 = ((wSaturation + 240) * wLuminosity + 120) / 240;
3576 wMid1 = wLuminosity * 2 - wMid2;
3578 wRed = GET_RGB(wHue + 80);
3579 wGreen = GET_RGB(wHue);
3580 wBlue = GET_RGB(wHue - 80);
3582 return RGB(wRed, wGreen, wBlue);
3585 wRed = wLuminosity * 255 / 240;
3586 return RGB(wRed, wRed, wRed);
3589 /*************************************************************************
3590 * @ [SHLWAPI.413]
3592 * Get the current docking status of the system.
3594 * PARAMS
3595 * dwFlags [I] DOCKINFO_ flags from "winbase.h", unused
3597 * RETURNS
3598 * One of DOCKINFO_UNDOCKED, DOCKINFO_UNDOCKED, or 0 if the system is not
3599 * a notebook.
3601 DWORD WINAPI SHGetMachineInfo(DWORD dwFlags)
3603 HW_PROFILE_INFOA hwInfo;
3605 TRACE("(0x%08x)\n", dwFlags);
3607 GetCurrentHwProfileA(&hwInfo);
3608 switch (hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED))
3610 case DOCKINFO_DOCKED:
3611 case DOCKINFO_UNDOCKED:
3612 return hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED);
3613 default:
3614 return 0;
3618 /*************************************************************************
3619 * @ [SHLWAPI.418]
3621 * Function seems to do FreeLibrary plus other things.
3623 * FIXME native shows the following calls:
3624 * RtlEnterCriticalSection
3625 * LocalFree
3626 * GetProcAddress(Comctl32??, 150L)
3627 * DPA_DeletePtr
3628 * RtlLeaveCriticalSection
3629 * followed by the FreeLibrary.
3630 * The above code may be related to .377 above.
3632 BOOL WINAPI MLFreeLibrary(HMODULE hModule)
3634 FIXME("(%p) semi-stub\n", hModule);
3635 return FreeLibrary(hModule);
3638 /*************************************************************************
3639 * @ [SHLWAPI.419]
3641 BOOL WINAPI SHFlushSFCacheWrap(void) {
3642 FIXME(": stub\n");
3643 return TRUE;
3646 /*************************************************************************
3647 * @ [SHLWAPI.429]
3648 * FIXME I have no idea what this function does or what its arguments are.
3650 BOOL WINAPI MLIsMLHInstance(HINSTANCE hInst)
3652 FIXME("(%p) stub\n", hInst);
3653 return FALSE;
3657 /*************************************************************************
3658 * @ [SHLWAPI.430]
3660 DWORD WINAPI MLSetMLHInstance(HINSTANCE hInst, HANDLE hHeap)
3662 FIXME("(%p,%p) stub\n", hInst, hHeap);
3663 return E_FAIL; /* This is what is used if shlwapi not loaded */
3666 /*************************************************************************
3667 * @ [SHLWAPI.431]
3669 DWORD WINAPI MLClearMLHInstance(DWORD x)
3671 FIXME("(0x%08x)stub\n", x);
3672 return 0xabba1247;
3675 /*************************************************************************
3676 * @ [SHLWAPI.436]
3678 * Convert an Unicode string CLSID into a CLSID.
3680 * PARAMS
3681 * idstr [I] string containing a CLSID in text form
3682 * id [O] CLSID extracted from the string
3684 * RETURNS
3685 * S_OK on success or E_INVALIDARG on failure
3687 HRESULT WINAPI CLSIDFromStringWrap(LPCWSTR idstr, CLSID *id)
3689 return CLSIDFromString((LPOLESTR)idstr, id);
3692 /*************************************************************************
3693 * @ [SHLWAPI.437]
3695 * Determine if the OS supports a given feature.
3697 * PARAMS
3698 * dwFeature [I] Feature requested (undocumented)
3700 * RETURNS
3701 * TRUE If the feature is available.
3702 * FALSE If the feature is not available.
3704 BOOL WINAPI IsOS(DWORD feature)
3706 OSVERSIONINFOA osvi;
3707 DWORD platform, majorv, minorv;
3709 osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOA);
3710 if(!GetVersionExA(&osvi)) {
3711 ERR("GetVersionEx failed\n");
3712 return FALSE;
3715 majorv = osvi.dwMajorVersion;
3716 minorv = osvi.dwMinorVersion;
3717 platform = osvi.dwPlatformId;
3719 #define ISOS_RETURN(x) \
3720 TRACE("(0x%x) ret=%d\n",feature,(x)); \
3721 return (x);
3723 switch(feature) {
3724 case OS_WIN32SORGREATER:
3725 ISOS_RETURN(platform == VER_PLATFORM_WIN32s
3726 || platform == VER_PLATFORM_WIN32_WINDOWS)
3727 case OS_NT:
3728 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3729 case OS_WIN95ORGREATER:
3730 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS)
3731 case OS_NT4ORGREATER:
3732 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 4)
3733 case OS_WIN2000ORGREATER_ALT:
3734 case OS_WIN2000ORGREATER:
3735 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3736 case OS_WIN98ORGREATER:
3737 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 10)
3738 case OS_WIN98_GOLD:
3739 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 10)
3740 case OS_WIN2000PRO:
3741 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3742 case OS_WIN2000SERVER:
3743 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3744 case OS_WIN2000ADVSERVER:
3745 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3746 case OS_WIN2000DATACENTER:
3747 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3748 case OS_WIN2000TERMINAL:
3749 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3750 case OS_EMBEDDED:
3751 FIXME("(OS_EMBEDDED) What should we return here?\n");
3752 return FALSE;
3753 case OS_TERMINALCLIENT:
3754 FIXME("(OS_TERMINALCLIENT) What should we return here?\n");
3755 return FALSE;
3756 case OS_TERMINALREMOTEADMIN:
3757 FIXME("(OS_TERMINALREMOTEADMIN) What should we return here?\n");
3758 return FALSE;
3759 case OS_WIN95_GOLD:
3760 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 0)
3761 case OS_MEORGREATER:
3762 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 90)
3763 case OS_XPORGREATER:
3764 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
3765 case OS_HOME:
3766 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
3767 case OS_PROFESSIONAL:
3768 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3769 case OS_DATACENTER:
3770 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3771 case OS_ADVSERVER:
3772 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3773 case OS_SERVER:
3774 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3775 case OS_TERMINALSERVER:
3776 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3777 case OS_PERSONALTERMINALSERVER:
3778 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && minorv >= 1 && majorv >= 5)
3779 case OS_FASTUSERSWITCHING:
3780 FIXME("(OS_FASTUSERSWITCHING) What should we return here?\n");
3781 return TRUE;
3782 case OS_WELCOMELOGONUI:
3783 FIXME("(OS_WELCOMELOGONUI) What should we return here?\n");
3784 return FALSE;
3785 case OS_DOMAINMEMBER:
3786 FIXME("(OS_DOMAINMEMBER) What should we return here?\n");
3787 return TRUE;
3788 case OS_ANYSERVER:
3789 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3790 case OS_WOW6432:
3791 FIXME("(OS_WOW6432) Should we check this?\n");
3792 return FALSE;
3793 case OS_WEBSERVER:
3794 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3795 case OS_SMALLBUSINESSSERVER:
3796 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3797 case OS_TABLETPC:
3798 FIXME("(OS_TABLEPC) What should we return here?\n");
3799 return FALSE;
3800 case OS_SERVERADMINUI:
3801 FIXME("(OS_SERVERADMINUI) What should we return here?\n");
3802 return FALSE;
3803 case OS_MEDIACENTER:
3804 FIXME("(OS_MEDIACENTER) What should we return here?\n");
3805 return FALSE;
3806 case OS_APPLIANCE:
3807 FIXME("(OS_APPLIANCE) What should we return here?\n");
3808 return FALSE;
3811 #undef ISOS_RETURN
3813 WARN("(0x%x) unknown parameter\n",feature);
3815 return FALSE;
3818 /*************************************************************************
3819 * @ [SHLWAPI.439]
3821 HRESULT WINAPI SHLoadRegUIStringW(HKEY hkey, LPCWSTR value, LPWSTR buf, DWORD size)
3823 DWORD type, sz = size;
3825 if(RegQueryValueExW(hkey, value, NULL, &type, (LPBYTE)buf, &sz) != ERROR_SUCCESS)
3826 return E_FAIL;
3828 return SHLoadIndirectString(buf, buf, size, NULL);
3831 /*************************************************************************
3832 * @ [SHLWAPI.478]
3834 * Call IInputObject_TranslateAcceleratorIO() on an object.
3836 * PARAMS
3837 * lpUnknown [I] Object supporting the IInputObject interface.
3838 * lpMsg [I] Key message to be processed.
3840 * RETURNS
3841 * Success: S_OK.
3842 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
3844 HRESULT WINAPI IUnknown_TranslateAcceleratorIO(IUnknown *lpUnknown, LPMSG lpMsg)
3846 IInputObject* lpInput = NULL;
3847 HRESULT hRet = E_INVALIDARG;
3849 TRACE("(%p,%p)\n", lpUnknown, lpMsg);
3850 if (lpUnknown)
3852 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
3853 (void**)&lpInput);
3854 if (SUCCEEDED(hRet) && lpInput)
3856 hRet = IInputObject_TranslateAcceleratorIO(lpInput, lpMsg);
3857 IInputObject_Release(lpInput);
3860 return hRet;
3863 /*************************************************************************
3864 * @ [SHLWAPI.481]
3866 * Call IInputObject_HasFocusIO() on an object.
3868 * PARAMS
3869 * lpUnknown [I] Object supporting the IInputObject interface.
3871 * RETURNS
3872 * Success: S_OK, if lpUnknown is an IInputObject object and has the focus,
3873 * or S_FALSE otherwise.
3874 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
3876 HRESULT WINAPI IUnknown_HasFocusIO(IUnknown *lpUnknown)
3878 IInputObject* lpInput = NULL;
3879 HRESULT hRet = E_INVALIDARG;
3881 TRACE("(%p)\n", lpUnknown);
3882 if (lpUnknown)
3884 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
3885 (void**)&lpInput);
3886 if (SUCCEEDED(hRet) && lpInput)
3888 hRet = IInputObject_HasFocusIO(lpInput);
3889 IInputObject_Release(lpInput);
3892 return hRet;
3895 /*************************************************************************
3896 * ColorRGBToHLS [SHLWAPI.@]
3898 * Convert an rgb COLORREF into the hls color space.
3900 * PARAMS
3901 * cRGB [I] Source rgb value
3902 * pwHue [O] Destination for converted hue
3903 * pwLuminance [O] Destination for converted luminance
3904 * pwSaturation [O] Destination for converted saturation
3906 * RETURNS
3907 * Nothing. pwHue, pwLuminance and pwSaturation are set to the converted
3908 * values.
3910 * NOTES
3911 * Output HLS values are constrained to the range (0..240).
3912 * For Achromatic conversions, Hue is set to 160.
3914 VOID WINAPI ColorRGBToHLS(COLORREF cRGB, LPWORD pwHue,
3915 LPWORD pwLuminance, LPWORD pwSaturation)
3917 int wR, wG, wB, wMax, wMin, wHue, wLuminosity, wSaturation;
3919 TRACE("(%08x,%p,%p,%p)\n", cRGB, pwHue, pwLuminance, pwSaturation);
3921 wR = GetRValue(cRGB);
3922 wG = GetGValue(cRGB);
3923 wB = GetBValue(cRGB);
3925 wMax = max(wR, max(wG, wB));
3926 wMin = min(wR, min(wG, wB));
3928 /* Luminosity */
3929 wLuminosity = ((wMax + wMin) * 240 + 255) / 510;
3931 if (wMax == wMin)
3933 /* Achromatic case */
3934 wSaturation = 0;
3935 /* Hue is now unrepresentable, but this is what native returns... */
3936 wHue = 160;
3938 else
3940 /* Chromatic case */
3941 int wDelta = wMax - wMin, wRNorm, wGNorm, wBNorm;
3943 /* Saturation */
3944 if (wLuminosity <= 120)
3945 wSaturation = ((wMax + wMin)/2 + wDelta * 240) / (wMax + wMin);
3946 else
3947 wSaturation = ((510 - wMax - wMin)/2 + wDelta * 240) / (510 - wMax - wMin);
3949 /* Hue */
3950 wRNorm = (wDelta/2 + wMax * 40 - wR * 40) / wDelta;
3951 wGNorm = (wDelta/2 + wMax * 40 - wG * 40) / wDelta;
3952 wBNorm = (wDelta/2 + wMax * 40 - wB * 40) / wDelta;
3954 if (wR == wMax)
3955 wHue = wBNorm - wGNorm;
3956 else if (wG == wMax)
3957 wHue = 80 + wRNorm - wBNorm;
3958 else
3959 wHue = 160 + wGNorm - wRNorm;
3960 if (wHue < 0)
3961 wHue += 240;
3962 else if (wHue > 240)
3963 wHue -= 240;
3965 if (pwHue)
3966 *pwHue = wHue;
3967 if (pwLuminance)
3968 *pwLuminance = wLuminosity;
3969 if (pwSaturation)
3970 *pwSaturation = wSaturation;
3973 /*************************************************************************
3974 * SHCreateShellPalette [SHLWAPI.@]
3976 HPALETTE WINAPI SHCreateShellPalette(HDC hdc)
3978 FIXME("stub\n");
3979 return CreateHalftonePalette(hdc);
3982 /*************************************************************************
3983 * SHGetInverseCMAP (SHLWAPI.@)
3985 * Get an inverse color map table.
3987 * PARAMS
3988 * lpCmap [O] Destination for color map
3989 * dwSize [I] Size of memory pointed to by lpCmap
3991 * RETURNS
3992 * Success: S_OK.
3993 * Failure: E_POINTER, If lpCmap is invalid.
3994 * E_INVALIDARG, If dwFlags is invalid
3995 * E_OUTOFMEMORY, If there is no memory available
3997 * NOTES
3998 * dwSize may only be CMAP_PTR_SIZE (4) or CMAP_SIZE (8192).
3999 * If dwSize = CMAP_PTR_SIZE, *lpCmap is set to the address of this DLL's
4000 * internal CMap.
4001 * If dwSize = CMAP_SIZE, lpCmap is filled with a copy of the data from
4002 * this DLL's internal CMap.
4004 HRESULT WINAPI SHGetInverseCMAP(LPDWORD dest, DWORD dwSize)
4006 if (dwSize == 4) {
4007 FIXME(" - returning bogus address for SHGetInverseCMAP\n");
4008 *dest = (DWORD)0xabba1249;
4009 return 0;
4011 FIXME("(%p, %#x) stub\n", dest, dwSize);
4012 return 0;
4015 /*************************************************************************
4016 * SHIsLowMemoryMachine [SHLWAPI.@]
4018 * Determine if the current computer has low memory.
4020 * PARAMS
4021 * x [I] FIXME
4023 * RETURNS
4024 * TRUE if the users machine has 16 Megabytes of memory or less,
4025 * FALSE otherwise.
4027 BOOL WINAPI SHIsLowMemoryMachine (DWORD x)
4029 FIXME("(0x%08x) stub\n", x);
4030 return FALSE;
4033 /*************************************************************************
4034 * GetMenuPosFromID [SHLWAPI.@]
4036 * Return the position of a menu item from its Id.
4038 * PARAMS
4039 * hMenu [I] Menu containing the item
4040 * wID [I] Id of the menu item
4042 * RETURNS
4043 * Success: The index of the menu item in hMenu.
4044 * Failure: -1, If the item is not found.
4046 INT WINAPI GetMenuPosFromID(HMENU hMenu, UINT wID)
4048 MENUITEMINFOW mi;
4049 INT nCount = GetMenuItemCount(hMenu), nIter = 0;
4051 while (nIter < nCount)
4053 mi.cbSize = sizeof(mi);
4054 mi.fMask = MIIM_ID;
4055 if (GetMenuItemInfoW(hMenu, nIter, TRUE, &mi) && mi.wID == wID)
4056 return nIter;
4057 nIter++;
4059 return -1;
4062 /*************************************************************************
4063 * @ [SHLWAPI.179]
4065 * Same as SHLWAPI.GetMenuPosFromID
4067 DWORD WINAPI SHMenuIndexFromID(HMENU hMenu, UINT uID)
4069 return GetMenuPosFromID(hMenu, uID);
4073 /*************************************************************************
4074 * @ [SHLWAPI.448]
4076 VOID WINAPI FixSlashesAndColonW(LPWSTR lpwstr)
4078 while (*lpwstr)
4080 if (*lpwstr == '/')
4081 *lpwstr = '\\';
4082 lpwstr++;
4087 /*************************************************************************
4088 * @ [SHLWAPI.461]
4090 DWORD WINAPI SHGetAppCompatFlags(DWORD dwUnknown)
4092 FIXME("(0x%08x) stub\n", dwUnknown);
4093 return 0;
4097 /*************************************************************************
4098 * @ [SHLWAPI.549]
4100 HRESULT WINAPI SHCoCreateInstanceAC(REFCLSID rclsid, LPUNKNOWN pUnkOuter,
4101 DWORD dwClsContext, REFIID iid, LPVOID *ppv)
4103 return CoCreateInstance(rclsid, pUnkOuter, dwClsContext, iid, ppv);
4106 /*************************************************************************
4107 * SHSkipJunction [SHLWAPI.@]
4109 * Determine if a bind context can be bound to an object
4111 * PARAMS
4112 * pbc [I] Bind context to check
4113 * pclsid [I] CLSID of object to be bound to
4115 * RETURNS
4116 * TRUE: If it is safe to bind
4117 * FALSE: If pbc is invalid or binding would not be safe
4120 BOOL WINAPI SHSkipJunction(IBindCtx *pbc, const CLSID *pclsid)
4122 static WCHAR szSkipBinding[] = { 'S','k','i','p',' ',
4123 'B','i','n','d','i','n','g',' ','C','L','S','I','D','\0' };
4124 BOOL bRet = FALSE;
4126 if (pbc)
4128 IUnknown* lpUnk;
4130 if (SUCCEEDED(IBindCtx_GetObjectParam(pbc, (LPOLESTR)szSkipBinding, &lpUnk)))
4132 CLSID clsid;
4134 if (SUCCEEDED(IUnknown_GetClassID(lpUnk, &clsid)) &&
4135 IsEqualGUID(pclsid, &clsid))
4136 bRet = TRUE;
4138 IUnknown_Release(lpUnk);
4141 return bRet;
4144 /***********************************************************************
4145 * SHGetShellKey (SHLWAPI.@)
4147 DWORD WINAPI SHGetShellKey(DWORD a, DWORD b, DWORD c)
4149 FIXME("(%x, %x, %x): stub\n", a, b, c);
4150 return 0x50;
4153 /***********************************************************************
4154 * SHQueueUserWorkItem (SHLWAPI.@)
4156 BOOL WINAPI SHQueueUserWorkItem(LPTHREAD_START_ROUTINE pfnCallback,
4157 LPVOID pContext, LONG lPriority, DWORD_PTR dwTag,
4158 DWORD_PTR *pdwId, LPCSTR pszModule, DWORD dwFlags)
4160 TRACE("(%p, %p, %d, %lx, %p, %s, %08x)\n", pfnCallback, pContext,
4161 lPriority, dwTag, pdwId, debugstr_a(pszModule), dwFlags);
4163 if(lPriority || dwTag || pdwId || pszModule || dwFlags)
4164 FIXME("Unsupported arguments\n");
4166 return QueueUserWorkItem(pfnCallback, pContext, 0);
4169 /***********************************************************************
4170 * SHSetTimerQueueTimer (SHLWAPI.263)
4172 HANDLE WINAPI SHSetTimerQueueTimer(HANDLE hQueue,
4173 WAITORTIMERCALLBACK pfnCallback, LPVOID pContext, DWORD dwDueTime,
4174 DWORD dwPeriod, LPCSTR lpszLibrary, DWORD dwFlags)
4176 HANDLE hNewTimer;
4178 /* SHSetTimerQueueTimer flags -> CreateTimerQueueTimer flags */
4179 if (dwFlags & TPS_LONGEXECTIME) {
4180 dwFlags &= ~TPS_LONGEXECTIME;
4181 dwFlags |= WT_EXECUTELONGFUNCTION;
4183 if (dwFlags & TPS_EXECUTEIO) {
4184 dwFlags &= ~TPS_EXECUTEIO;
4185 dwFlags |= WT_EXECUTEINIOTHREAD;
4188 if (!CreateTimerQueueTimer(&hNewTimer, hQueue, pfnCallback, pContext,
4189 dwDueTime, dwPeriod, dwFlags))
4190 return NULL;
4192 return hNewTimer;
4195 /***********************************************************************
4196 * IUnknown_OnFocusChangeIS (SHLWAPI.@)
4198 HRESULT WINAPI IUnknown_OnFocusChangeIS(LPUNKNOWN lpUnknown, LPUNKNOWN pFocusObject, BOOL bFocus)
4200 IInputObjectSite *pIOS = NULL;
4201 HRESULT hRet = E_INVALIDARG;
4203 TRACE("(%p, %p, %s)\n", lpUnknown, pFocusObject, bFocus ? "TRUE" : "FALSE");
4205 if (lpUnknown)
4207 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObjectSite,
4208 (void **)&pIOS);
4209 if (SUCCEEDED(hRet) && pIOS)
4211 hRet = IInputObjectSite_OnFocusChangeIS(pIOS, pFocusObject, bFocus);
4212 IInputObjectSite_Release(pIOS);
4215 return hRet;
4218 /***********************************************************************
4219 * SHGetValueW (SHLWAPI.@)
4221 HRESULT WINAPI SKGetValueW(DWORD a, LPWSTR b, LPWSTR c, DWORD d, DWORD e, DWORD f)
4223 FIXME("(%x, %s, %s, %x, %x, %x): stub\n", a, debugstr_w(b), debugstr_w(c), d, e, f);
4224 return E_FAIL;
4227 typedef HRESULT (WINAPI *DllGetVersion_func)(DLLVERSIONINFO *);
4229 /***********************************************************************
4230 * GetUIVersion (SHLWAPI.452)
4232 DWORD WINAPI GetUIVersion(void)
4234 static DWORD version;
4236 if (!version)
4238 DllGetVersion_func pDllGetVersion;
4239 HMODULE dll = LoadLibraryA("shell32.dll");
4240 if (!dll) return 0;
4242 pDllGetVersion = (DllGetVersion_func)GetProcAddress(dll, "DllGetVersion");
4243 if (pDllGetVersion)
4245 DLLVERSIONINFO dvi;
4246 dvi.cbSize = sizeof(DLLVERSIONINFO);
4247 if (pDllGetVersion(&dvi) == S_OK) version = dvi.dwMajorVersion;
4249 FreeLibrary( dll );
4250 if (!version) version = 3; /* old shell dlls don't have DllGetVersion */
4252 return version;
4255 /***********************************************************************
4256 * ShellMessageBoxWrapW [SHLWAPI.388]
4258 * See shell32.ShellMessageBoxW
4260 * NOTE:
4261 * shlwapi.ShellMessageBoxWrapW is a duplicate of shell32.ShellMessageBoxW
4262 * because we can't forward to it in the .spec file since it's exported by
4263 * ordinal. If you change the implementation here please update the code in
4264 * shell32 as well.
4266 INT WINAPIV ShellMessageBoxWrapW(HINSTANCE hInstance, HWND hWnd, LPCWSTR lpText,
4267 LPCWSTR lpCaption, UINT uType, ...)
4269 WCHAR szText[100], szTitle[100];
4270 LPCWSTR pszText = szText, pszTitle = szTitle;
4271 LPWSTR pszTemp;
4272 va_list args;
4273 int ret;
4275 va_start(args, uType);
4277 TRACE("(%p,%p,%p,%p,%08x)\n", hInstance, hWnd, lpText, lpCaption, uType);
4279 if (IS_INTRESOURCE(lpCaption))
4280 LoadStringW(hInstance, LOWORD(lpCaption), szTitle, sizeof(szTitle)/sizeof(szTitle[0]));
4281 else
4282 pszTitle = lpCaption;
4284 if (IS_INTRESOURCE(lpText))
4285 LoadStringW(hInstance, LOWORD(lpText), szText, sizeof(szText)/sizeof(szText[0]));
4286 else
4287 pszText = lpText;
4289 FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
4290 pszText, 0, 0, (LPWSTR)&pszTemp, 0, &args);
4292 va_end(args);
4294 ret = MessageBoxW(hWnd, pszTemp, pszTitle, uType);
4295 LocalFree((HLOCAL)pszTemp);
4296 return ret;
4299 HRESULT WINAPI IUnknown_QueryServiceExec(IUnknown *unk, REFIID service, REFIID clsid,
4300 DWORD x1, DWORD x2, DWORD x3, void **ppvOut)
4302 FIXME("%p %s %s %08x %08x %08x %p\n", unk,
4303 debugstr_guid(service), debugstr_guid(clsid), x1, x2, x3, ppvOut);
4304 return E_NOTIMPL;
4307 HRESULT WINAPI IUnknown_ProfferService(IUnknown *unk, void *x0, void *x1, void *x2)
4309 FIXME("%p %p %p %p\n", unk, x0, x1, x2);
4310 return E_NOTIMPL;
4313 /***********************************************************************
4314 * ZoneComputePaneSize [SHLWAPI.382]
4316 UINT WINAPI ZoneComputePaneSize(HWND hwnd)
4318 FIXME("\n");
4319 return 0x95;
4322 /***********************************************************************
4323 * SHChangeNotifyWrap [SHLWAPI.394]
4325 void WINAPI SHChangeNotifyWrap(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2)
4327 SHChangeNotify(wEventId, uFlags, dwItem1, dwItem2);
4330 typedef struct SHELL_USER_SID { /* according to MSDN this should be in shlobj.h... */
4331 SID_IDENTIFIER_AUTHORITY sidAuthority;
4332 DWORD dwUserGroupID;
4333 DWORD dwUserID;
4334 } SHELL_USER_SID, *PSHELL_USER_SID;
4336 typedef struct SHELL_USER_PERMISSION { /* ...and this should be in shlwapi.h */
4337 SHELL_USER_SID susID;
4338 DWORD dwAccessType;
4339 BOOL fInherit;
4340 DWORD dwAccessMask;
4341 DWORD dwInheritMask;
4342 DWORD dwInheritAccessMask;
4343 } SHELL_USER_PERMISSION, *PSHELL_USER_PERMISSION;
4345 /***********************************************************************
4346 * GetShellSecurityDescriptor [SHLWAPI.475]
4348 * prepares SECURITY_DESCRIPTOR from a set of ACEs
4350 * PARAMS
4351 * apUserPerm [I] array of pointers to SHELL_USER_PERMISSION structures,
4352 * each of which describes permissions to apply
4353 * cUserPerm [I] number of entries in apUserPerm array
4355 * RETURNS
4356 * success: pointer to SECURITY_DESCRIPTOR
4357 * failure: NULL
4359 * NOTES
4360 * Call should free returned descriptor with LocalFree
4362 PSECURITY_DESCRIPTOR WINAPI GetShellSecurityDescriptor(PSHELL_USER_PERMISSION *apUserPerm, int cUserPerm)
4364 PSID *sidlist;
4365 PSID cur_user = NULL;
4366 BYTE tuUser[2000];
4367 DWORD acl_size;
4368 int sid_count, i;
4369 PSECURITY_DESCRIPTOR psd = NULL;
4371 TRACE("%p %d\n", apUserPerm, cUserPerm);
4373 if (apUserPerm == NULL || cUserPerm <= 0)
4374 return NULL;
4376 sidlist = HeapAlloc(GetProcessHeap(), 0, cUserPerm * sizeof(PSID));
4377 if (!sidlist)
4378 return NULL;
4380 acl_size = sizeof(ACL);
4382 for(sid_count = 0; sid_count < cUserPerm; sid_count++)
4384 static SHELL_USER_SID null_sid = {{SECURITY_NULL_SID_AUTHORITY}, 0, 0};
4385 PSHELL_USER_PERMISSION perm = apUserPerm[sid_count];
4386 PSHELL_USER_SID sid = &perm->susID;
4387 PSID pSid;
4388 BOOL ret = TRUE;
4390 if (!memcmp((void*)sid, (void*)&null_sid, sizeof(SHELL_USER_SID)))
4391 { /* current user's SID */
4392 if (!cur_user)
4394 HANDLE Token;
4395 DWORD bufsize = sizeof(tuUser);
4397 ret = OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY, &Token);
4398 if (ret)
4400 ret = GetTokenInformation(Token, TokenUser, (void*)tuUser, bufsize, &bufsize );
4401 if (ret)
4402 cur_user = ((PTOKEN_USER)&tuUser)->User.Sid;
4403 CloseHandle(Token);
4406 pSid = cur_user;
4407 } else if (sid->dwUserID==0) /* one sub-authority */
4408 ret = AllocateAndInitializeSid(&sid->sidAuthority, 1, sid->dwUserGroupID, 0,
4409 0, 0, 0, 0, 0, 0, &pSid);
4410 else
4411 ret = AllocateAndInitializeSid(&sid->sidAuthority, 2, sid->dwUserGroupID, sid->dwUserID,
4412 0, 0, 0, 0, 0, 0, &pSid);
4413 if (!ret)
4414 goto free_sids;
4416 sidlist[sid_count] = pSid;
4417 /* increment acl_size (1 ACE for non-inheritable and 2 ACEs for inheritable records */
4418 acl_size += (sizeof(ACCESS_ALLOWED_ACE)-sizeof(DWORD) + GetLengthSid(pSid)) * (perm->fInherit ? 2 : 1);
4421 psd = LocalAlloc(0, sizeof(SECURITY_DESCRIPTOR) + acl_size);
4423 if (psd != NULL)
4425 PACL pAcl = (PACL)(((BYTE*)psd)+sizeof(SECURITY_DESCRIPTOR));
4427 if (!InitializeSecurityDescriptor(psd, SECURITY_DESCRIPTOR_REVISION))
4428 goto error;
4430 if (!InitializeAcl(pAcl, acl_size, ACL_REVISION))
4431 goto error;
4433 for(i = 0; i < sid_count; i++)
4435 PSHELL_USER_PERMISSION sup = apUserPerm[i];
4436 PSID sid = sidlist[i];
4438 switch(sup->dwAccessType)
4440 case ACCESS_ALLOWED_ACE_TYPE:
4441 if (!AddAccessAllowedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4442 goto error;
4443 if (sup->fInherit && !AddAccessAllowedAceEx(pAcl, ACL_REVISION,
4444 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4445 goto error;
4446 break;
4447 case ACCESS_DENIED_ACE_TYPE:
4448 if (!AddAccessDeniedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4449 goto error;
4450 if (sup->fInherit && !AddAccessDeniedAceEx(pAcl, ACL_REVISION,
4451 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4452 goto error;
4453 break;
4454 default:
4455 goto error;
4459 if (!SetSecurityDescriptorDacl(psd, TRUE, pAcl, FALSE))
4460 goto error;
4462 goto free_sids;
4464 error:
4465 LocalFree(psd);
4466 psd = NULL;
4467 free_sids:
4468 for(i = 0; i < sid_count; i++)
4470 if (!cur_user || sidlist[i] != cur_user)
4471 FreeSid(sidlist[i]);
4473 HeapFree(GetProcessHeap(), 0, sidlist);
4475 return psd;