dlls: Fix va_list -> ms_va_list for variadic api calls
[wine/wine64.git] / dlls / shlwapi / ordinal.c
bloba5e7c67d787ab953435e9ef7afd15df2fd46a633
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 superfluous.
66 The reason for these functions to be there is to provide a wrapper
67 for unicode functions to provide these functions on systems without
68 unicode functions eg. win95/win98. Since we have such functions we just
69 call these. If running Wine with native DLLs, some late bound calls may
70 fail. However, it is better to implement the functions in the forward DLL
71 and recommend the builtin rather than reimplementing the calls here!
74 /*************************************************************************
75 * SHLWAPI_DupSharedHandle
77 * Internal implemetation of SHLWAPI_11.
79 static HANDLE SHLWAPI_DupSharedHandle(HANDLE hShared, DWORD dwDstProcId,
80 DWORD dwSrcProcId, DWORD dwAccess,
81 DWORD dwOptions)
83 HANDLE hDst, hSrc;
84 DWORD dwMyProcId = GetCurrentProcessId();
85 HANDLE hRet = NULL;
87 TRACE("(%p,%d,%d,%08x,%08x)\n", hShared, dwDstProcId, dwSrcProcId,
88 dwAccess, dwOptions);
90 /* Get dest process handle */
91 if (dwDstProcId == dwMyProcId)
92 hDst = GetCurrentProcess();
93 else
94 hDst = OpenProcess(PROCESS_DUP_HANDLE, 0, dwDstProcId);
96 if (hDst)
98 /* Get src process handle */
99 if (dwSrcProcId == dwMyProcId)
100 hSrc = GetCurrentProcess();
101 else
102 hSrc = OpenProcess(PROCESS_DUP_HANDLE, 0, dwSrcProcId);
104 if (hSrc)
106 /* Make handle available to dest process */
107 if (!DuplicateHandle(hDst, hShared, hSrc, &hRet,
108 dwAccess, 0, dwOptions | DUPLICATE_SAME_ACCESS))
109 hRet = NULL;
111 if (dwSrcProcId != dwMyProcId)
112 CloseHandle(hSrc);
115 if (dwDstProcId != dwMyProcId)
116 CloseHandle(hDst);
119 TRACE("Returning handle %p\n", hRet);
120 return hRet;
123 /*************************************************************************
124 * @ [SHLWAPI.7]
126 * Create a block of sharable memory and initialise it with data.
128 * PARAMS
129 * lpvData [I] Pointer to data to write
130 * dwSize [I] Size of data
131 * dwProcId [I] ID of process owning data
133 * RETURNS
134 * Success: A shared memory handle
135 * Failure: NULL
137 * NOTES
138 * Ordinals 7-11 provide a set of calls to create shared memory between a
139 * group of processes. The shared memory is treated opaquely in that its size
140 * is not exposed to clients who map it. This is accomplished by storing
141 * the size of the map as the first DWORD of mapped data, and then offsetting
142 * the view pointer returned by this size.
145 HANDLE WINAPI SHAllocShared(LPCVOID lpvData, DWORD dwSize, DWORD dwProcId)
147 HANDLE hMap;
148 LPVOID pMapped;
149 HANDLE hRet = NULL;
151 TRACE("(%p,%d,%d)\n", lpvData, dwSize, dwProcId);
153 /* Create file mapping of the correct length */
154 hMap = CreateFileMappingA(INVALID_HANDLE_VALUE, NULL, FILE_MAP_READ, 0,
155 dwSize + sizeof(dwSize), NULL);
156 if (!hMap)
157 return hRet;
159 /* Get a view in our process address space */
160 pMapped = MapViewOfFile(hMap, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
162 if (pMapped)
164 /* Write size of data, followed by the data, to the view */
165 *((DWORD*)pMapped) = dwSize;
166 if (lpvData)
167 memcpy((char *) pMapped + sizeof(dwSize), lpvData, dwSize);
169 /* Release view. All further views mapped will be opaque */
170 UnmapViewOfFile(pMapped);
171 hRet = SHLWAPI_DupSharedHandle(hMap, dwProcId,
172 GetCurrentProcessId(), FILE_MAP_ALL_ACCESS,
173 DUPLICATE_SAME_ACCESS);
176 CloseHandle(hMap);
177 return hRet;
180 /*************************************************************************
181 * @ [SHLWAPI.8]
183 * Get a pointer to a block of shared memory from a shared memory handle.
185 * PARAMS
186 * hShared [I] Shared memory handle
187 * dwProcId [I] ID of process owning hShared
189 * RETURNS
190 * Success: A pointer to the shared memory
191 * Failure: NULL
194 PVOID WINAPI SHLockShared(HANDLE hShared, DWORD dwProcId)
196 HANDLE hDup;
197 LPVOID pMapped;
199 TRACE("(%p %d)\n", hShared, dwProcId);
201 /* Get handle to shared memory for current process */
202 hDup = SHLWAPI_DupSharedHandle(hShared, dwProcId, GetCurrentProcessId(),
203 FILE_MAP_ALL_ACCESS, 0);
204 /* Get View */
205 pMapped = MapViewOfFile(hDup, FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);
206 CloseHandle(hDup);
208 if (pMapped)
209 return (char *) pMapped + sizeof(DWORD); /* Hide size */
210 return NULL;
213 /*************************************************************************
214 * @ [SHLWAPI.9]
216 * Release a pointer to a block of shared memory.
218 * PARAMS
219 * lpView [I] Shared memory pointer
221 * RETURNS
222 * Success: TRUE
223 * Failure: FALSE
226 BOOL WINAPI SHUnlockShared(LPVOID lpView)
228 TRACE("(%p)\n", lpView);
229 return UnmapViewOfFile((char *) lpView - sizeof(DWORD)); /* Include size */
232 /*************************************************************************
233 * @ [SHLWAPI.10]
235 * Destroy a block of sharable memory.
237 * PARAMS
238 * hShared [I] Shared memory handle
239 * dwProcId [I] ID of process owning hShared
241 * RETURNS
242 * Success: TRUE
243 * Failure: FALSE
246 BOOL WINAPI SHFreeShared(HANDLE hShared, DWORD dwProcId)
248 HANDLE hClose;
250 TRACE("(%p %d)\n", hShared, dwProcId);
252 /* Get a copy of the handle for our process, closing the source handle */
253 hClose = SHLWAPI_DupSharedHandle(hShared, dwProcId, GetCurrentProcessId(),
254 FILE_MAP_ALL_ACCESS,DUPLICATE_CLOSE_SOURCE);
255 /* Close local copy */
256 return CloseHandle(hClose);
259 /*************************************************************************
260 * @ [SHLWAPI.11]
262 * Copy a sharable memory handle from one process to another.
264 * PARAMS
265 * hShared [I] Shared memory handle to duplicate
266 * dwDstProcId [I] ID of the process wanting the duplicated handle
267 * dwSrcProcId [I] ID of the process owning hShared
268 * dwAccess [I] Desired DuplicateHandle() access
269 * dwOptions [I] Desired DuplicateHandle() options
271 * RETURNS
272 * Success: A handle suitable for use by the dwDstProcId process.
273 * Failure: A NULL handle.
276 HANDLE WINAPI SHMapHandle(HANDLE hShared, DWORD dwDstProcId, DWORD dwSrcProcId,
277 DWORD dwAccess, DWORD dwOptions)
279 HANDLE hRet;
281 hRet = SHLWAPI_DupSharedHandle(hShared, dwDstProcId, dwSrcProcId,
282 dwAccess, dwOptions);
283 return hRet;
286 /*************************************************************************
287 * @ [SHLWAPI.13]
289 * Create and register a clipboard enumerator for a web browser.
291 * PARAMS
292 * lpBC [I] Binding context
293 * lpUnknown [I] An object exposing the IWebBrowserApp interface
295 * RETURNS
296 * Success: S_OK.
297 * Failure: An HRESULT error code.
299 * NOTES
300 * The enumerator is stored as a property of the web browser. If it does not
301 * yet exist, it is created and set before being registered.
303 HRESULT WINAPI RegisterDefaultAcceptHeaders(LPBC lpBC, IUnknown *lpUnknown)
305 static const WCHAR szProperty[] = { '{','D','0','F','C','A','4','2','0',
306 '-','D','3','F','5','-','1','1','C','F', '-','B','2','1','1','-','0',
307 '0','A','A','0','0','4','A','E','8','3','7','}','\0' };
308 BSTR property;
309 IEnumFORMATETC* pIEnumFormatEtc = NULL;
310 VARIANTARG var;
311 HRESULT hRet;
312 IWebBrowserApp* pBrowser = NULL;
314 TRACE("(%p, %p)\n", lpBC, lpUnknown);
316 /* Get An IWebBrowserApp interface from lpUnknown */
317 hRet = IUnknown_QueryService(lpUnknown, &IID_IWebBrowserApp, &IID_IWebBrowserApp, (PVOID)&pBrowser);
318 if (FAILED(hRet) || !pBrowser)
319 return E_NOINTERFACE;
321 V_VT(&var) = VT_EMPTY;
323 /* The property we get is the browsers clipboard enumerator */
324 property = SysAllocString(szProperty);
325 hRet = IWebBrowserApp_GetProperty(pBrowser, property, &var);
326 SysFreeString(property);
327 if (FAILED(hRet))
328 return hRet;
330 if (V_VT(&var) == VT_EMPTY)
332 /* Iterate through accepted documents and RegisterClipBoardFormatA() them */
333 char szKeyBuff[128], szValueBuff[128];
334 DWORD dwKeySize, dwValueSize, dwRet = 0, dwCount = 0, dwNumValues, dwType;
335 FORMATETC* formatList, *format;
336 HKEY hDocs;
338 TRACE("Registering formats and creating IEnumFORMATETC instance\n");
340 if (!RegOpenKeyA(HKEY_LOCAL_MACHINE, "Software\\Microsoft\\Windows\\Current"
341 "Version\\Internet Settings\\Accepted Documents", &hDocs))
342 return E_FAIL;
344 /* Get count of values in key */
345 while (!dwRet)
347 dwKeySize = sizeof(szKeyBuff);
348 dwRet = RegEnumValueA(hDocs,dwCount,szKeyBuff,&dwKeySize,0,&dwType,0,0);
349 dwCount++;
352 dwNumValues = dwCount;
354 /* Note: dwCount = number of items + 1; The extra item is the end node */
355 format = formatList = HeapAlloc(GetProcessHeap(), 0, dwCount * sizeof(FORMATETC));
356 if (!formatList)
357 return E_OUTOFMEMORY;
359 if (dwNumValues > 1)
361 dwRet = 0;
362 dwCount = 0;
364 dwNumValues--;
366 /* Register clipboard formats for the values and populate format list */
367 while(!dwRet && dwCount < dwNumValues)
369 dwKeySize = sizeof(szKeyBuff);
370 dwValueSize = sizeof(szValueBuff);
371 dwRet = RegEnumValueA(hDocs, dwCount, szKeyBuff, &dwKeySize, 0, &dwType,
372 (PBYTE)szValueBuff, &dwValueSize);
373 if (!dwRet)
374 return E_FAIL;
376 format->cfFormat = RegisterClipboardFormatA(szValueBuff);
377 format->ptd = NULL;
378 format->dwAspect = 1;
379 format->lindex = 4;
380 format->tymed = -1;
382 format++;
383 dwCount++;
387 /* Terminate the (maybe empty) list, last entry has a cfFormat of 0 */
388 format->cfFormat = 0;
389 format->ptd = NULL;
390 format->dwAspect = 1;
391 format->lindex = 4;
392 format->tymed = -1;
394 /* Create a clipboard enumerator */
395 hRet = CreateFormatEnumerator(dwNumValues, formatList, &pIEnumFormatEtc);
397 if (FAILED(hRet) || !pIEnumFormatEtc)
398 return hRet;
400 /* Set our enumerator as the browsers property */
401 V_VT(&var) = VT_UNKNOWN;
402 V_UNKNOWN(&var) = (IUnknown*)pIEnumFormatEtc;
404 hRet = IWebBrowserApp_PutProperty(pBrowser, (BSTR)szProperty, var);
405 if (FAILED(hRet))
407 IEnumFORMATETC_Release(pIEnumFormatEtc);
408 goto RegisterDefaultAcceptHeaders_Exit;
412 if (V_VT(&var) == VT_UNKNOWN)
414 /* Our variant is holding the clipboard enumerator */
415 IUnknown* pIUnknown = V_UNKNOWN(&var);
416 IEnumFORMATETC* pClone = NULL;
418 TRACE("Retrieved IEnumFORMATETC property\n");
420 /* Get an IEnumFormatEtc interface from the variants value */
421 pIEnumFormatEtc = NULL;
422 hRet = IUnknown_QueryInterface(pIUnknown, &IID_IEnumFORMATETC,
423 (PVOID)&pIEnumFormatEtc);
424 if (hRet == S_OK && pIEnumFormatEtc)
426 /* Clone and register the enumerator */
427 hRet = IEnumFORMATETC_Clone(pIEnumFormatEtc, &pClone);
428 if (hRet == S_OK && pClone)
430 RegisterFormatEnumerator(lpBC, pClone, 0);
432 IEnumFORMATETC_Release(pClone);
435 /* Release the IEnumFormatEtc interface */
436 IEnumFORMATETC_Release(pIUnknown);
438 IUnknown_Release(V_UNKNOWN(&var));
441 RegisterDefaultAcceptHeaders_Exit:
442 IWebBrowserApp_Release(pBrowser);
443 return hRet;
446 /*************************************************************************
447 * @ [SHLWAPI.15]
449 * Get Explorers "AcceptLanguage" setting.
451 * PARAMS
452 * langbuf [O] Destination for language string
453 * buflen [I] Length of langbuf
454 * [0] Success: used length of langbuf
456 * RETURNS
457 * Success: S_OK. langbuf is set to the language string found.
458 * Failure: E_FAIL, If any arguments are invalid, error occurred, or Explorer
459 * does not contain the setting.
460 * E_INVALIDARG, If the buffer is not big enough
462 HRESULT WINAPI GetAcceptLanguagesW( LPWSTR langbuf, LPDWORD buflen)
464 static const WCHAR szkeyW[] = {
465 'S','o','f','t','w','a','r','e','\\',
466 'M','i','c','r','o','s','o','f','t','\\',
467 'I','n','t','e','r','n','e','t',' ','E','x','p','l','o','r','e','r','\\',
468 'I','n','t','e','r','n','a','t','i','o','n','a','l',0};
469 static const WCHAR valueW[] = {
470 'A','c','c','e','p','t','L','a','n','g','u','a','g','e',0};
471 static const WCHAR enusW[] = {'e','n','-','u','s',0};
472 DWORD mystrlen, mytype;
473 HKEY mykey;
474 HRESULT retval;
475 LCID mylcid;
476 WCHAR *mystr;
478 if(!langbuf || !buflen || !*buflen)
479 return E_FAIL;
481 mystrlen = (*buflen > 20) ? *buflen : 20 ;
482 mystr = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * mystrlen);
483 RegOpenKeyW(HKEY_CURRENT_USER, szkeyW, &mykey);
484 if(RegQueryValueExW(mykey, valueW, 0, &mytype, (PBYTE)mystr, &mystrlen)) {
485 /* Did not find value */
486 mylcid = GetUserDefaultLCID();
487 /* somehow the mylcid translates into "en-us"
488 * this is similar to "LOCALE_SABBREVLANGNAME"
489 * which could be gotten via GetLocaleInfo.
490 * The only problem is LOCALE_SABBREVLANGUAGE" is
491 * a 3 char string (first 2 are country code and third is
492 * letter for "sublanguage", which does not come close to
493 * "en-us"
495 lstrcpyW(mystr, enusW);
496 mystrlen = lstrlenW(mystr);
497 } else {
498 /* handle returned string */
499 FIXME("missing code\n");
501 memcpy( langbuf, mystr, min(*buflen,strlenW(mystr)+1)*sizeof(WCHAR) );
503 if(*buflen > strlenW(mystr)) {
504 *buflen = strlenW(mystr);
505 retval = S_OK;
506 } else {
507 *buflen = 0;
508 retval = E_INVALIDARG;
509 SetLastError(ERROR_INSUFFICIENT_BUFFER);
511 RegCloseKey(mykey);
512 HeapFree(GetProcessHeap(), 0, mystr);
513 return retval;
516 /*************************************************************************
517 * @ [SHLWAPI.14]
519 * Ascii version of GetAcceptLanguagesW.
521 HRESULT WINAPI GetAcceptLanguagesA( LPSTR langbuf, LPDWORD buflen)
523 WCHAR *langbufW;
524 DWORD buflenW, convlen;
525 HRESULT retval;
527 if(!langbuf || !buflen || !*buflen) return E_FAIL;
529 buflenW = *buflen;
530 langbufW = HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * buflenW);
531 retval = GetAcceptLanguagesW(langbufW, &buflenW);
533 if (retval == S_OK)
535 convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, -1, langbuf, *buflen, NULL, NULL);
537 else /* copy partial string anyway */
539 convlen = WideCharToMultiByte(CP_ACP, 0, langbufW, *buflen, langbuf, *buflen, NULL, NULL);
540 if (convlen < *buflen) langbuf[convlen] = 0;
542 *buflen = buflenW ? convlen : 0;
544 HeapFree(GetProcessHeap(), 0, langbufW);
545 return retval;
548 /*************************************************************************
549 * @ [SHLWAPI.23]
551 * Convert a GUID to a string.
553 * PARAMS
554 * guid [I] GUID to convert
555 * lpszDest [O] Destination for string
556 * cchMax [I] Length of output buffer
558 * RETURNS
559 * The length of the string created.
561 INT WINAPI SHStringFromGUIDA(REFGUID guid, LPSTR lpszDest, INT cchMax)
563 char xguid[40];
564 INT iLen;
566 TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
568 sprintf(xguid, "{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}",
569 guid->Data1, guid->Data2, guid->Data3,
570 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
571 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
573 iLen = strlen(xguid) + 1;
575 if (iLen > cchMax)
576 return 0;
577 memcpy(lpszDest, xguid, iLen);
578 return iLen;
581 /*************************************************************************
582 * @ [SHLWAPI.24]
584 * Convert a GUID to a string.
586 * PARAMS
587 * guid [I] GUID to convert
588 * str [O] Destination for string
589 * cmax [I] Length of output buffer
591 * RETURNS
592 * The length of the string created.
594 INT WINAPI SHStringFromGUIDW(REFGUID guid, LPWSTR lpszDest, INT cchMax)
596 WCHAR xguid[40];
597 INT iLen;
598 static const WCHAR wszFormat[] = {'{','%','0','8','l','X','-','%','0','4','X','-','%','0','4','X','-',
599 '%','0','2','X','%','0','2','X','-','%','0','2','X','%','0','2','X','%','0','2','X','%','0','2',
600 'X','%','0','2','X','%','0','2','X','}',0};
602 TRACE("(%s,%p,%d)\n", debugstr_guid(guid), lpszDest, cchMax);
604 sprintfW(xguid, wszFormat, guid->Data1, guid->Data2, guid->Data3,
605 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
606 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
608 iLen = strlenW(xguid) + 1;
610 if (iLen > cchMax)
611 return 0;
612 memcpy(lpszDest, xguid, iLen*sizeof(WCHAR));
613 return iLen;
616 /*************************************************************************
617 * @ [SHLWAPI.29]
619 * Determine if a Unicode character is a space.
621 * PARAMS
622 * wc [I] Character to check.
624 * RETURNS
625 * TRUE, if wc is a space,
626 * FALSE otherwise.
628 BOOL WINAPI IsCharSpaceW(WCHAR wc)
630 WORD CharType;
632 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_SPACE);
635 /*************************************************************************
636 * @ [SHLWAPI.30]
638 * Determine if a Unicode character is a blank.
640 * PARAMS
641 * wc [I] Character to check.
643 * RETURNS
644 * TRUE, if wc is a blank,
645 * FALSE otherwise.
648 BOOL WINAPI IsCharBlankW(WCHAR wc)
650 WORD CharType;
652 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_BLANK);
655 /*************************************************************************
656 * @ [SHLWAPI.31]
658 * Determine if a Unicode character is punctuation.
660 * PARAMS
661 * wc [I] Character to check.
663 * RETURNS
664 * TRUE, if wc is punctuation,
665 * FALSE otherwise.
667 BOOL WINAPI IsCharPunctW(WCHAR wc)
669 WORD CharType;
671 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_PUNCT);
674 /*************************************************************************
675 * @ [SHLWAPI.32]
677 * Determine if a Unicode character is a control character.
679 * PARAMS
680 * wc [I] Character to check.
682 * RETURNS
683 * TRUE, if wc is a control character,
684 * FALSE otherwise.
686 BOOL WINAPI IsCharCntrlW(WCHAR wc)
688 WORD CharType;
690 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_CNTRL);
693 /*************************************************************************
694 * @ [SHLWAPI.33]
696 * Determine if a Unicode character is a digit.
698 * PARAMS
699 * wc [I] Character to check.
701 * RETURNS
702 * TRUE, if wc is a digit,
703 * FALSE otherwise.
705 BOOL WINAPI IsCharDigitW(WCHAR wc)
707 WORD CharType;
709 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_DIGIT);
712 /*************************************************************************
713 * @ [SHLWAPI.34]
715 * Determine if a Unicode character is a hex digit.
717 * PARAMS
718 * wc [I] Character to check.
720 * RETURNS
721 * TRUE, if wc is a hex digit,
722 * FALSE otherwise.
724 BOOL WINAPI IsCharXDigitW(WCHAR wc)
726 WORD CharType;
728 return GetStringTypeW(CT_CTYPE1, &wc, 1, &CharType) && (CharType & C1_XDIGIT);
731 /*************************************************************************
732 * @ [SHLWAPI.35]
735 BOOL WINAPI GetStringType3ExW(LPWSTR src, INT count, LPWORD type)
737 return GetStringTypeW(CT_CTYPE3, src, count, type);
740 /*************************************************************************
741 * @ [SHLWAPI.151]
743 * Compare two Ascii strings up to a given length.
745 * PARAMS
746 * lpszSrc [I] Source string
747 * lpszCmp [I] String to compare to lpszSrc
748 * len [I] Maximum length
750 * RETURNS
751 * A number greater than, less than or equal to 0 depending on whether
752 * lpszSrc is greater than, less than or equal to lpszCmp.
754 DWORD WINAPI StrCmpNCA(LPCSTR lpszSrc, LPCSTR lpszCmp, INT len)
756 return StrCmpNA(lpszSrc, lpszCmp, len);
759 /*************************************************************************
760 * @ [SHLWAPI.152]
762 * Unicode version of StrCmpNCA.
764 DWORD WINAPI StrCmpNCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, INT len)
766 return StrCmpNW(lpszSrc, lpszCmp, len);
769 /*************************************************************************
770 * @ [SHLWAPI.153]
772 * Compare two Ascii strings up to a given length, ignoring case.
774 * PARAMS
775 * lpszSrc [I] Source string
776 * lpszCmp [I] String to compare to lpszSrc
777 * len [I] Maximum length
779 * RETURNS
780 * A number greater than, less than or equal to 0 depending on whether
781 * lpszSrc is greater than, less than or equal to lpszCmp.
783 DWORD WINAPI StrCmpNICA(LPCSTR lpszSrc, LPCSTR lpszCmp, DWORD len)
785 return StrCmpNIA(lpszSrc, lpszCmp, len);
788 /*************************************************************************
789 * @ [SHLWAPI.154]
791 * Unicode version of StrCmpNICA.
793 DWORD WINAPI StrCmpNICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp, DWORD len)
795 return StrCmpNIW(lpszSrc, lpszCmp, len);
798 /*************************************************************************
799 * @ [SHLWAPI.155]
801 * Compare two Ascii strings.
803 * PARAMS
804 * lpszSrc [I] Source string
805 * lpszCmp [I] String to compare to lpszSrc
807 * RETURNS
808 * A number greater than, less than or equal to 0 depending on whether
809 * lpszSrc is greater than, less than or equal to lpszCmp.
811 DWORD WINAPI StrCmpCA(LPCSTR lpszSrc, LPCSTR lpszCmp)
813 return lstrcmpA(lpszSrc, lpszCmp);
816 /*************************************************************************
817 * @ [SHLWAPI.156]
819 * Unicode version of StrCmpCA.
821 DWORD WINAPI StrCmpCW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
823 return lstrcmpW(lpszSrc, lpszCmp);
826 /*************************************************************************
827 * @ [SHLWAPI.157]
829 * Compare two Ascii strings, ignoring case.
831 * PARAMS
832 * lpszSrc [I] Source string
833 * lpszCmp [I] String to compare to lpszSrc
835 * RETURNS
836 * A number greater than, less than or equal to 0 depending on whether
837 * lpszSrc is greater than, less than or equal to lpszCmp.
839 DWORD WINAPI StrCmpICA(LPCSTR lpszSrc, LPCSTR lpszCmp)
841 return lstrcmpiA(lpszSrc, lpszCmp);
844 /*************************************************************************
845 * @ [SHLWAPI.158]
847 * Unicode version of StrCmpICA.
849 DWORD WINAPI StrCmpICW(LPCWSTR lpszSrc, LPCWSTR lpszCmp)
851 return lstrcmpiW(lpszSrc, lpszCmp);
854 /*************************************************************************
855 * @ [SHLWAPI.160]
857 * Get an identification string for the OS and explorer.
859 * PARAMS
860 * lpszDest [O] Destination for Id string
861 * dwDestLen [I] Length of lpszDest
863 * RETURNS
864 * TRUE, If the string was created successfully
865 * FALSE, Otherwise
867 BOOL WINAPI SHAboutInfoA(LPSTR lpszDest, DWORD dwDestLen)
869 WCHAR buff[2084];
871 TRACE("(%p,%d)\n", lpszDest, dwDestLen);
873 if (lpszDest && SHAboutInfoW(buff, dwDestLen))
875 WideCharToMultiByte(CP_ACP, 0, buff, -1, lpszDest, dwDestLen, NULL, NULL);
876 return TRUE;
878 return FALSE;
881 /*************************************************************************
882 * @ [SHLWAPI.161]
884 * Unicode version of SHAboutInfoA.
886 BOOL WINAPI SHAboutInfoW(LPWSTR lpszDest, DWORD dwDestLen)
888 static const WCHAR szIEKey[] = { 'S','O','F','T','W','A','R','E','\\',
889 'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
890 ' ','E','x','p','l','o','r','e','r','\0' };
891 static const WCHAR szWinNtKey[] = { 'S','O','F','T','W','A','R','E','\\',
892 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s',' ',
893 'N','T','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
894 static const WCHAR szWinKey[] = { 'S','O','F','T','W','A','R','E','\\',
895 'M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\',
896 'C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0' };
897 static const WCHAR szRegKey[] = { 'S','O','F','T','W','A','R','E','\\',
898 'M','i','c','r','o','s','o','f','t','\\','I','n','t','e','r','n','e','t',
899 ' ','E','x','p','l','o','r','e','r','\\',
900 'R','e','g','i','s','t','r','a','t','i','o','n','\0' };
901 static const WCHAR szVersion[] = { 'V','e','r','s','i','o','n','\0' };
902 static const WCHAR szCustomized[] = { 'C','u','s','t','o','m','i','z','e','d',
903 'V','e','r','s','i','o','n','\0' };
904 static const WCHAR szOwner[] = { 'R','e','g','i','s','t','e','r','e','d',
905 'O','w','n','e','r','\0' };
906 static const WCHAR szOrg[] = { 'R','e','g','i','s','t','e','r','e','d',
907 'O','r','g','a','n','i','z','a','t','i','o','n','\0' };
908 static const WCHAR szProduct[] = { 'P','r','o','d','u','c','t','I','d','\0' };
909 static const WCHAR szUpdate[] = { 'I','E','A','K',
910 'U','p','d','a','t','e','U','r','l','\0' };
911 static const WCHAR szHelp[] = { 'I','E','A','K',
912 'H','e','l','p','S','t','r','i','n','g','\0' };
913 WCHAR buff[2084];
914 HKEY hReg;
915 DWORD dwType, dwLen;
917 TRACE("(%p,%d)\n", lpszDest, dwDestLen);
919 if (!lpszDest)
920 return FALSE;
922 *lpszDest = '\0';
924 /* Try the NT key first, followed by 95/98 key */
925 if (RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinNtKey, 0, KEY_READ, &hReg) &&
926 RegOpenKeyExW(HKEY_LOCAL_MACHINE, szWinKey, 0, KEY_READ, &hReg))
927 return FALSE;
929 /* OS Version */
930 buff[0] = '\0';
931 dwLen = 30;
932 if (!SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey, szVersion, &dwType, buff, &dwLen))
934 DWORD dwStrLen = strlenW(buff);
935 dwLen = 30 - dwStrLen;
936 SHGetValueW(HKEY_LOCAL_MACHINE, szIEKey,
937 szCustomized, &dwType, buff+dwStrLen, &dwLen);
939 StrCatBuffW(lpszDest, buff, dwDestLen);
941 /* ~Registered Owner */
942 buff[0] = '~';
943 dwLen = 256;
944 if (SHGetValueW(hReg, szOwner, 0, &dwType, buff+1, &dwLen))
945 buff[1] = '\0';
946 StrCatBuffW(lpszDest, buff, dwDestLen);
948 /* ~Registered Organization */
949 dwLen = 256;
950 if (SHGetValueW(hReg, szOrg, 0, &dwType, buff+1, &dwLen))
951 buff[1] = '\0';
952 StrCatBuffW(lpszDest, buff, dwDestLen);
954 /* FIXME: Not sure where this number comes from */
955 buff[0] = '~';
956 buff[1] = '0';
957 buff[2] = '\0';
958 StrCatBuffW(lpszDest, buff, dwDestLen);
960 /* ~Product Id */
961 dwLen = 256;
962 if (SHGetValueW(HKEY_LOCAL_MACHINE, szRegKey, szProduct, &dwType, buff+1, &dwLen))
963 buff[1] = '\0';
964 StrCatBuffW(lpszDest, buff, dwDestLen);
966 /* ~IE Update Url */
967 dwLen = 2048;
968 if(SHGetValueW(HKEY_LOCAL_MACHINE, szWinKey, szUpdate, &dwType, buff+1, &dwLen))
969 buff[1] = '\0';
970 StrCatBuffW(lpszDest, buff, dwDestLen);
972 /* ~IE Help String */
973 dwLen = 256;
974 if(SHGetValueW(hReg, szHelp, 0, &dwType, buff+1, &dwLen))
975 buff[1] = '\0';
976 StrCatBuffW(lpszDest, buff, dwDestLen);
978 RegCloseKey(hReg);
979 return TRUE;
982 /*************************************************************************
983 * @ [SHLWAPI.163]
985 * Call IOleCommandTarget_QueryStatus() on an object.
987 * PARAMS
988 * lpUnknown [I] Object supporting the IOleCommandTarget interface
989 * pguidCmdGroup [I] GUID for the command group
990 * cCmds [I]
991 * prgCmds [O] Commands
992 * pCmdText [O] Command text
994 * RETURNS
995 * Success: S_OK.
996 * Failure: E_FAIL, if lpUnknown is NULL.
997 * E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
998 * Otherwise, an error code from IOleCommandTarget_QueryStatus().
1000 HRESULT WINAPI IUnknown_QueryStatus(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
1001 ULONG cCmds, OLECMD *prgCmds, OLECMDTEXT* pCmdText)
1003 HRESULT hRet = E_FAIL;
1005 TRACE("(%p,%p,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, cCmds, prgCmds, pCmdText);
1007 if (lpUnknown)
1009 IOleCommandTarget* lpOle;
1011 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
1012 (void**)&lpOle);
1014 if (SUCCEEDED(hRet) && lpOle)
1016 hRet = IOleCommandTarget_QueryStatus(lpOle, pguidCmdGroup, cCmds,
1017 prgCmds, pCmdText);
1018 IOleCommandTarget_Release(lpOle);
1021 return hRet;
1024 /*************************************************************************
1025 * @ [SHLWAPI.164]
1027 * Call IOleCommandTarget_Exec() on an object.
1029 * PARAMS
1030 * lpUnknown [I] Object supporting the IOleCommandTarget interface
1031 * pguidCmdGroup [I] GUID for the command group
1033 * RETURNS
1034 * Success: S_OK.
1035 * Failure: E_FAIL, if lpUnknown is NULL.
1036 * E_NOINTERFACE, if lpUnknown does not support IOleCommandTarget.
1037 * Otherwise, an error code from IOleCommandTarget_Exec().
1039 HRESULT WINAPI IUnknown_Exec(IUnknown* lpUnknown, REFGUID pguidCmdGroup,
1040 DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
1041 VARIANT* pvaOut)
1043 HRESULT hRet = E_FAIL;
1045 TRACE("(%p,%p,%d,%d,%p,%p)\n",lpUnknown, pguidCmdGroup, nCmdID,
1046 nCmdexecopt, pvaIn, pvaOut);
1048 if (lpUnknown)
1050 IOleCommandTarget* lpOle;
1052 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleCommandTarget,
1053 (void**)&lpOle);
1054 if (SUCCEEDED(hRet) && lpOle)
1056 hRet = IOleCommandTarget_Exec(lpOle, pguidCmdGroup, nCmdID,
1057 nCmdexecopt, pvaIn, pvaOut);
1058 IOleCommandTarget_Release(lpOle);
1061 return hRet;
1064 /*************************************************************************
1065 * @ [SHLWAPI.165]
1067 * Retrieve, modify, and re-set a value from a window.
1069 * PARAMS
1070 * hWnd [I] Window to get value from
1071 * offset [I] Offset of value
1072 * wMask [I] Mask for uiFlags
1073 * wFlags [I] Bits to set in window value
1075 * RETURNS
1076 * The new value as it was set, or 0 if any parameter is invalid.
1078 * NOTES
1079 * Any bits set in uiMask are cleared from the value, then any bits set in
1080 * uiFlags are set in the value.
1082 LONG WINAPI SHSetWindowBits(HWND hwnd, INT offset, UINT wMask, UINT wFlags)
1084 LONG ret = GetWindowLongA(hwnd, offset);
1085 LONG newFlags = (wFlags & wMask) | (ret & ~wFlags);
1087 if (newFlags != ret)
1088 ret = SetWindowLongA(hwnd, offset, newFlags);
1089 return ret;
1092 /*************************************************************************
1093 * @ [SHLWAPI.167]
1095 * Change a window's parent.
1097 * PARAMS
1098 * hWnd [I] Window to change parent of
1099 * hWndParent [I] New parent window
1101 * RETURNS
1102 * The old parent of hWnd.
1104 * NOTES
1105 * If hWndParent is NULL (desktop), the window style is changed to WS_POPUP.
1106 * If hWndParent is NOT NULL then we set the WS_CHILD style.
1108 HWND WINAPI SHSetParentHwnd(HWND hWnd, HWND hWndParent)
1110 TRACE("%p, %p\n", hWnd, hWndParent);
1112 if(GetParent(hWnd) == hWndParent)
1113 return 0;
1115 if(hWndParent)
1116 SHSetWindowBits(hWnd, GWL_STYLE, WS_CHILD, WS_CHILD);
1117 else
1118 SHSetWindowBits(hWnd, GWL_STYLE, WS_POPUP, WS_POPUP);
1120 return SetParent(hWnd, hWndParent);
1123 /*************************************************************************
1124 * @ [SHLWAPI.168]
1126 * Locate and advise a connection point in an IConnectionPointContainer object.
1128 * PARAMS
1129 * lpUnkSink [I] Sink for the connection point advise call
1130 * riid [I] REFIID of connection point to advise
1131 * bAdviseOnly [I] TRUE = Advise only, FALSE = Unadvise first
1132 * lpUnknown [I] Object supporting the IConnectionPointContainer interface
1133 * lpCookie [O] Pointer to connection point cookie
1134 * lppCP [O] Destination for the IConnectionPoint found
1136 * RETURNS
1137 * Success: S_OK. If lppCP is non-NULL, it is filled with the IConnectionPoint
1138 * that was advised. The caller is responsible for releasing it.
1139 * Failure: E_FAIL, if any arguments are invalid.
1140 * E_NOINTERFACE, if lpUnknown isn't an IConnectionPointContainer,
1141 * Or an HRESULT error code if any call fails.
1143 HRESULT WINAPI ConnectToConnectionPoint(IUnknown* lpUnkSink, REFIID riid, BOOL bAdviseOnly,
1144 IUnknown* lpUnknown, LPDWORD lpCookie,
1145 IConnectionPoint **lppCP)
1147 HRESULT hRet;
1148 IConnectionPointContainer* lpContainer;
1149 IConnectionPoint *lpCP;
1151 if(!lpUnknown || (bAdviseOnly && !lpUnkSink))
1152 return E_FAIL;
1154 if(lppCP)
1155 *lppCP = NULL;
1157 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer,
1158 (void**)&lpContainer);
1159 if (SUCCEEDED(hRet))
1161 hRet = IConnectionPointContainer_FindConnectionPoint(lpContainer, riid, &lpCP);
1163 if (SUCCEEDED(hRet))
1165 if(!bAdviseOnly)
1166 hRet = IConnectionPoint_Unadvise(lpCP, *lpCookie);
1167 hRet = IConnectionPoint_Advise(lpCP, lpUnkSink, lpCookie);
1169 if (FAILED(hRet))
1170 *lpCookie = 0;
1172 if (lppCP && SUCCEEDED(hRet))
1173 *lppCP = lpCP; /* Caller keeps the interface */
1174 else
1175 IConnectionPoint_Release(lpCP); /* Release it */
1178 IUnknown_Release(lpContainer);
1180 return hRet;
1183 /*************************************************************************
1184 * @ [SHLWAPI.169]
1186 * Release an interface.
1188 * PARAMS
1189 * lpUnknown [I] Object to release
1191 * RETURNS
1192 * Nothing.
1194 DWORD WINAPI IUnknown_AtomicRelease(IUnknown ** lpUnknown)
1196 IUnknown *temp;
1198 TRACE("(%p)\n",lpUnknown);
1200 if(!lpUnknown || !*((LPDWORD)lpUnknown)) return 0;
1201 temp = *lpUnknown;
1202 *lpUnknown = NULL;
1204 TRACE("doing Release\n");
1206 return IUnknown_Release(temp);
1209 /*************************************************************************
1210 * @ [SHLWAPI.170]
1212 * Skip '//' if present in a string.
1214 * PARAMS
1215 * lpszSrc [I] String to check for '//'
1217 * RETURNS
1218 * Success: The next character after the '//' or the string if not present
1219 * Failure: NULL, if lpszStr is NULL.
1221 LPCSTR WINAPI PathSkipLeadingSlashesA(LPCSTR lpszSrc)
1223 if (lpszSrc && lpszSrc[0] == '/' && lpszSrc[1] == '/')
1224 lpszSrc += 2;
1225 return lpszSrc;
1228 /*************************************************************************
1229 * @ [SHLWAPI.171]
1231 * Check if two interfaces come from the same object.
1233 * PARAMS
1234 * lpInt1 [I] Interface to check against lpInt2.
1235 * lpInt2 [I] Interface to check against lpInt1.
1237 * RETURNS
1238 * TRUE, If the interfaces come from the same object.
1239 * FALSE Otherwise.
1241 BOOL WINAPI SHIsSameObject(IUnknown* lpInt1, IUnknown* lpInt2)
1243 LPVOID lpUnknown1, lpUnknown2;
1245 TRACE("%p %p\n", lpInt1, lpInt2);
1247 if (!lpInt1 || !lpInt2)
1248 return FALSE;
1250 if (lpInt1 == lpInt2)
1251 return TRUE;
1253 if (FAILED(IUnknown_QueryInterface(lpInt1, &IID_IUnknown,
1254 (LPVOID *)&lpUnknown1)))
1255 return FALSE;
1257 if (FAILED(IUnknown_QueryInterface(lpInt2, &IID_IUnknown,
1258 (LPVOID *)&lpUnknown2)))
1259 return FALSE;
1261 if (lpUnknown1 == lpUnknown2)
1262 return TRUE;
1264 return FALSE;
1267 /*************************************************************************
1268 * @ [SHLWAPI.172]
1270 * Get the window handle of an object.
1272 * PARAMS
1273 * lpUnknown [I] Object to get the window handle of
1274 * lphWnd [O] Destination for window handle
1276 * RETURNS
1277 * Success: S_OK. lphWnd contains the objects window handle.
1278 * Failure: An HRESULT error code.
1280 * NOTES
1281 * lpUnknown is expected to support one of the following interfaces:
1282 * IOleWindow(), IInternetSecurityMgrSite(), or IShellView().
1284 HRESULT WINAPI IUnknown_GetWindow(IUnknown *lpUnknown, HWND *lphWnd)
1286 IUnknown *lpOle;
1287 HRESULT hRet = E_FAIL;
1289 TRACE("(%p,%p)\n", lpUnknown, lphWnd);
1291 if (!lpUnknown)
1292 return hRet;
1294 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleWindow, (void**)&lpOle);
1296 if (FAILED(hRet))
1298 hRet = IUnknown_QueryInterface(lpUnknown,&IID_IShellView, (void**)&lpOle);
1300 if (FAILED(hRet))
1302 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInternetSecurityMgrSite,
1303 (void**)&lpOle);
1307 if (SUCCEEDED(hRet))
1309 /* Lazyness here - Since GetWindow() is the first method for the above 3
1310 * interfaces, we use the same call for them all.
1312 hRet = IOleWindow_GetWindow((IOleWindow*)lpOle, lphWnd);
1313 IUnknown_Release(lpOle);
1314 if (lphWnd)
1315 TRACE("Returning HWND=%p\n", *lphWnd);
1318 return hRet;
1321 /*************************************************************************
1322 * @ [SHLWAPI.173]
1324 * Call a method on as as yet unidentified object.
1326 * PARAMS
1327 * pUnk [I] Object supporting the unidentified interface,
1328 * arg [I] Argument for the call on the object.
1330 * RETURNS
1331 * S_OK.
1333 HRESULT WINAPI IUnknown_SetOwner(IUnknown *pUnk, ULONG arg)
1335 static const GUID guid_173 = {
1336 0x5836fb00, 0x8187, 0x11cf, { 0xa1,0x2b,0x00,0xaa,0x00,0x4a,0xe8,0x37 }
1338 IMalloc *pUnk2;
1340 TRACE("(%p,%d)\n", pUnk, arg);
1342 /* Note: arg may not be a ULONG and pUnk2 is for sure not an IMalloc -
1343 * We use this interface as its vtable entry is compatible with the
1344 * object in question.
1345 * FIXME: Find out what this object is and where it should be defined.
1347 if (pUnk &&
1348 SUCCEEDED(IUnknown_QueryInterface(pUnk, &guid_173, (void**)&pUnk2)))
1350 IMalloc_Alloc(pUnk2, arg); /* Faked call!! */
1351 IMalloc_Release(pUnk2);
1353 return S_OK;
1356 /*************************************************************************
1357 * @ [SHLWAPI.174]
1359 * Call either IObjectWithSite_SetSite() or IInternetSecurityManager_SetSecuritySite() on
1360 * an object.
1363 HRESULT WINAPI IUnknown_SetSite(
1364 IUnknown *obj, /* [in] OLE object */
1365 IUnknown *site) /* [in] Site interface */
1367 HRESULT hr;
1368 IObjectWithSite *iobjwithsite;
1369 IInternetSecurityManager *isecmgr;
1371 if (!obj) return E_FAIL;
1373 hr = IUnknown_QueryInterface(obj, &IID_IObjectWithSite, (LPVOID *)&iobjwithsite);
1374 TRACE("IID_IObjectWithSite QI ret=%08x, %p\n", hr, iobjwithsite);
1375 if (SUCCEEDED(hr))
1377 hr = IObjectWithSite_SetSite(iobjwithsite, site);
1378 TRACE("done IObjectWithSite_SetSite ret=%08x\n", hr);
1379 IUnknown_Release(iobjwithsite);
1381 else
1383 hr = IUnknown_QueryInterface(obj, &IID_IInternetSecurityManager, (LPVOID *)&isecmgr);
1384 TRACE("IID_IInternetSecurityManager QI ret=%08x, %p\n", hr, isecmgr);
1385 if (FAILED(hr)) return hr;
1387 hr = IInternetSecurityManager_SetSecuritySite(isecmgr, (IInternetSecurityMgrSite *)site);
1388 TRACE("done IInternetSecurityManager_SetSecuritySite ret=%08x\n", hr);
1389 IUnknown_Release(isecmgr);
1391 return hr;
1394 /*************************************************************************
1395 * @ [SHLWAPI.175]
1397 * Call IPersist_GetClassID() on an object.
1399 * PARAMS
1400 * lpUnknown [I] Object supporting the IPersist interface
1401 * lpClassId [O] Destination for Class Id
1403 * RETURNS
1404 * Success: S_OK. lpClassId contains the Class Id requested.
1405 * Failure: E_FAIL, If lpUnknown is NULL,
1406 * E_NOINTERFACE If lpUnknown does not support IPersist,
1407 * Or an HRESULT error code.
1409 HRESULT WINAPI IUnknown_GetClassID(IUnknown *lpUnknown, CLSID* lpClassId)
1411 IPersist* lpPersist;
1412 HRESULT hRet = E_FAIL;
1414 TRACE("(%p,%p)\n", lpUnknown, debugstr_guid(lpClassId));
1416 if (lpUnknown)
1418 hRet = IUnknown_QueryInterface(lpUnknown,&IID_IPersist,(void**)&lpPersist);
1419 if (SUCCEEDED(hRet))
1421 IPersist_GetClassID(lpPersist, lpClassId);
1422 IPersist_Release(lpPersist);
1425 return hRet;
1428 /*************************************************************************
1429 * @ [SHLWAPI.176]
1431 * Retrieve a Service Interface from an object.
1433 * PARAMS
1434 * lpUnknown [I] Object to get an IServiceProvider interface from
1435 * sid [I] Service ID for IServiceProvider_QueryService() call
1436 * riid [I] Function requested for QueryService call
1437 * lppOut [O] Destination for the service interface pointer
1439 * RETURNS
1440 * Success: S_OK. lppOut contains an object providing the requested service
1441 * Failure: An HRESULT error code
1443 * NOTES
1444 * lpUnknown is expected to support the IServiceProvider interface.
1446 HRESULT WINAPI IUnknown_QueryService(IUnknown* lpUnknown, REFGUID sid, REFIID riid,
1447 LPVOID *lppOut)
1449 IServiceProvider* pService = NULL;
1450 HRESULT hRet;
1452 if (!lppOut)
1453 return E_FAIL;
1455 *lppOut = NULL;
1457 if (!lpUnknown)
1458 return E_FAIL;
1460 /* Get an IServiceProvider interface from the object */
1461 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IServiceProvider,
1462 (LPVOID*)&pService);
1464 if (hRet == S_OK && pService)
1466 TRACE("QueryInterface returned (IServiceProvider*)%p\n", pService);
1468 /* Get a Service interface from the object */
1469 hRet = IServiceProvider_QueryService(pService, sid, riid, lppOut);
1471 TRACE("(IServiceProvider*)%p returned (IUnknown*)%p\n", pService, *lppOut);
1473 /* Release the IServiceProvider interface */
1474 IUnknown_Release(pService);
1476 return hRet;
1479 /*************************************************************************
1480 * @ [SHLWAPI.177]
1482 * Loads a popup menu.
1484 * PARAMS
1485 * hInst [I] Instance handle
1486 * szName [I] Menu name
1488 * RETURNS
1489 * Success: TRUE.
1490 * Failure: FALSE.
1492 BOOL WINAPI SHLoadMenuPopup(HINSTANCE hInst, LPCWSTR szName)
1494 HMENU hMenu;
1496 if ((hMenu = LoadMenuW(hInst, szName)))
1498 if (GetSubMenu(hMenu, 0))
1499 RemoveMenu(hMenu, 0, MF_BYPOSITION);
1501 DestroyMenu(hMenu);
1502 return TRUE;
1504 return FALSE;
1507 typedef struct _enumWndData
1509 UINT uiMsgId;
1510 WPARAM wParam;
1511 LPARAM lParam;
1512 LRESULT (WINAPI *pfnPost)(HWND,UINT,WPARAM,LPARAM);
1513 } enumWndData;
1515 /* Callback for SHLWAPI_178 */
1516 static BOOL CALLBACK SHLWAPI_EnumChildProc(HWND hWnd, LPARAM lParam)
1518 enumWndData *data = (enumWndData *)lParam;
1520 TRACE("(%p,%p)\n", hWnd, data);
1521 data->pfnPost(hWnd, data->uiMsgId, data->wParam, data->lParam);
1522 return TRUE;
1525 /*************************************************************************
1526 * @ [SHLWAPI.178]
1528 * Send or post a message to every child of a window.
1530 * PARAMS
1531 * hWnd [I] Window whose children will get the messages
1532 * uiMsgId [I] Message Id
1533 * wParam [I] WPARAM of message
1534 * lParam [I] LPARAM of message
1535 * bSend [I] TRUE = Use SendMessageA(), FALSE = Use PostMessageA()
1537 * RETURNS
1538 * Nothing.
1540 * NOTES
1541 * The appropriate ASCII or Unicode function is called for the window.
1543 void WINAPI SHPropagateMessage(HWND hWnd, UINT uiMsgId, WPARAM wParam, LPARAM lParam, BOOL bSend)
1545 enumWndData data;
1547 TRACE("(%p,%u,%ld,%ld,%d)\n", hWnd, uiMsgId, wParam, lParam, bSend);
1549 if(hWnd)
1551 data.uiMsgId = uiMsgId;
1552 data.wParam = wParam;
1553 data.lParam = lParam;
1555 if (bSend)
1556 data.pfnPost = IsWindowUnicode(hWnd) ? (void*)SendMessageW : (void*)SendMessageA;
1557 else
1558 data.pfnPost = IsWindowUnicode(hWnd) ? (void*)PostMessageW : (void*)PostMessageA;
1560 EnumChildWindows(hWnd, SHLWAPI_EnumChildProc, (LPARAM)&data);
1564 /*************************************************************************
1565 * @ [SHLWAPI.180]
1567 * Remove all sub-menus from a menu.
1569 * PARAMS
1570 * hMenu [I] Menu to remove sub-menus from
1572 * RETURNS
1573 * Success: 0. All sub-menus under hMenu are removed
1574 * Failure: -1, if any parameter is invalid
1576 DWORD WINAPI SHRemoveAllSubMenus(HMENU hMenu)
1578 int iItemCount = GetMenuItemCount(hMenu) - 1;
1579 while (iItemCount >= 0)
1581 HMENU hSubMenu = GetSubMenu(hMenu, iItemCount);
1582 if (hSubMenu)
1583 RemoveMenu(hMenu, iItemCount, MF_BYPOSITION);
1584 iItemCount--;
1586 return iItemCount;
1589 /*************************************************************************
1590 * @ [SHLWAPI.181]
1592 * Enable or disable a menu item.
1594 * PARAMS
1595 * hMenu [I] Menu holding menu item
1596 * uID [I] ID of menu item to enable/disable
1597 * bEnable [I] Whether to enable (TRUE) or disable (FALSE) the item.
1599 * RETURNS
1600 * The return code from EnableMenuItem.
1602 UINT WINAPI SHEnableMenuItem(HMENU hMenu, UINT wItemID, BOOL bEnable)
1604 return EnableMenuItem(hMenu, wItemID, bEnable ? MF_ENABLED : MF_GRAYED);
1607 /*************************************************************************
1608 * @ [SHLWAPI.182]
1610 * Check or uncheck a menu item.
1612 * PARAMS
1613 * hMenu [I] Menu holding menu item
1614 * uID [I] ID of menu item to check/uncheck
1615 * bCheck [I] Whether to check (TRUE) or uncheck (FALSE) the item.
1617 * RETURNS
1618 * The return code from CheckMenuItem.
1620 DWORD WINAPI SHCheckMenuItem(HMENU hMenu, UINT uID, BOOL bCheck)
1622 return CheckMenuItem(hMenu, uID, bCheck ? MF_CHECKED : MF_UNCHECKED);
1625 /*************************************************************************
1626 * @ [SHLWAPI.183]
1628 * Register a window class if it isn't already.
1630 * PARAMS
1631 * lpWndClass [I] Window class to register
1633 * RETURNS
1634 * The result of the RegisterClassA call.
1636 DWORD WINAPI SHRegisterClassA(WNDCLASSA *wndclass)
1638 WNDCLASSA wca;
1639 if (GetClassInfoA(wndclass->hInstance, wndclass->lpszClassName, &wca))
1640 return TRUE;
1641 return (DWORD)RegisterClassA(wndclass);
1644 /*************************************************************************
1645 * @ [SHLWAPI.186]
1647 BOOL WINAPI SHSimulateDrop(IDropTarget *pDrop, IDataObject *pDataObj,
1648 DWORD grfKeyState, PPOINTL lpPt, DWORD* pdwEffect)
1650 DWORD dwEffect = DROPEFFECT_LINK | DROPEFFECT_MOVE | DROPEFFECT_COPY;
1651 POINTL pt = { 0, 0 };
1653 if (!lpPt)
1654 lpPt = &pt;
1656 if (!pdwEffect)
1657 pdwEffect = &dwEffect;
1659 IDropTarget_DragEnter(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1661 if (*pdwEffect)
1662 return IDropTarget_Drop(pDrop, pDataObj, grfKeyState, *lpPt, pdwEffect);
1664 IDropTarget_DragLeave(pDrop);
1665 return TRUE;
1668 /*************************************************************************
1669 * @ [SHLWAPI.187]
1671 * Call IPersistPropertyBag_Load() on an object.
1673 * PARAMS
1674 * lpUnknown [I] Object supporting the IPersistPropertyBag interface
1675 * lpPropBag [O] Destination for loaded IPropertyBag
1677 * RETURNS
1678 * Success: S_OK.
1679 * Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1681 DWORD WINAPI SHLoadFromPropertyBag(IUnknown *lpUnknown, IPropertyBag* lpPropBag)
1683 IPersistPropertyBag* lpPPBag;
1684 HRESULT hRet = E_FAIL;
1686 TRACE("(%p,%p)\n", lpUnknown, lpPropBag);
1688 if (lpUnknown)
1690 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IPersistPropertyBag,
1691 (void**)&lpPPBag);
1692 if (SUCCEEDED(hRet) && lpPPBag)
1694 hRet = IPersistPropertyBag_Load(lpPPBag, lpPropBag, NULL);
1695 IPersistPropertyBag_Release(lpPPBag);
1698 return hRet;
1701 /*************************************************************************
1702 * @ [SHLWAPI.188]
1704 * Call IOleControlSite_TranslateAccelerator() on an object.
1706 * PARAMS
1707 * lpUnknown [I] Object supporting the IOleControlSite interface.
1708 * lpMsg [I] Key message to be processed.
1709 * dwModifiers [I] Flags containing the state of the modifier keys.
1711 * RETURNS
1712 * Success: S_OK.
1713 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
1715 HRESULT WINAPI IUnknown_TranslateAcceleratorOCS(IUnknown *lpUnknown, LPMSG lpMsg, DWORD dwModifiers)
1717 IOleControlSite* lpCSite = NULL;
1718 HRESULT hRet = E_INVALIDARG;
1720 TRACE("(%p,%p,0x%08x)\n", lpUnknown, lpMsg, dwModifiers);
1721 if (lpUnknown)
1723 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1724 (void**)&lpCSite);
1725 if (SUCCEEDED(hRet) && lpCSite)
1727 hRet = IOleControlSite_TranslateAccelerator(lpCSite, lpMsg, dwModifiers);
1728 IOleControlSite_Release(lpCSite);
1731 return hRet;
1735 /*************************************************************************
1736 * @ [SHLWAPI.189]
1738 * Call IOleControlSite_OnFocus() on an object.
1740 * PARAMS
1741 * lpUnknown [I] Object supporting the IOleControlSite interface.
1742 * fGotFocus [I] Whether focus was gained (TRUE) or lost (FALSE).
1744 * RETURNS
1745 * Success: S_OK.
1746 * Failure: An HRESULT error code, or E_FAIL if lpUnknown is NULL.
1748 HRESULT WINAPI IUnknown_OnFocusOCS(IUnknown *lpUnknown, BOOL fGotFocus)
1750 IOleControlSite* lpCSite = NULL;
1751 HRESULT hRet = E_FAIL;
1753 TRACE("(%p,%s)\n", lpUnknown, fGotFocus ? "TRUE" : "FALSE");
1754 if (lpUnknown)
1756 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IOleControlSite,
1757 (void**)&lpCSite);
1758 if (SUCCEEDED(hRet) && lpCSite)
1760 hRet = IOleControlSite_OnFocus(lpCSite, fGotFocus);
1761 IOleControlSite_Release(lpCSite);
1764 return hRet;
1767 /*************************************************************************
1768 * @ [SHLWAPI.190]
1770 HRESULT WINAPI IUnknown_HandleIRestrict(LPUNKNOWN lpUnknown, PVOID lpArg1,
1771 PVOID lpArg2, PVOID lpArg3, PVOID lpArg4)
1773 /* FIXME: {D12F26B2-D90A-11D0-830D-00AA005B4383} - What object does this represent? */
1774 static const DWORD service_id[] = { 0xd12f26b2, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1775 /* FIXME: {D12F26B1-D90A-11D0-830D-00AA005B4383} - Also Unknown/undocumented */
1776 static const DWORD function_id[] = { 0xd12f26b1, 0x11d0d90a, 0xaa000d83, 0x83435b00 };
1777 HRESULT hRet = E_INVALIDARG;
1778 LPUNKNOWN lpUnkInner = NULL; /* FIXME: Real type is unknown */
1780 TRACE("(%p,%p,%p,%p,%p)\n", lpUnknown, lpArg1, lpArg2, lpArg3, lpArg4);
1782 if (lpUnknown && lpArg4)
1784 hRet = IUnknown_QueryService(lpUnknown, (REFGUID)service_id,
1785 (REFGUID)function_id, (void**)&lpUnkInner);
1787 if (SUCCEEDED(hRet) && lpUnkInner)
1789 /* FIXME: The type of service object requested is unknown, however
1790 * testing shows that its first method is called with 4 parameters.
1791 * Fake this by using IParseDisplayName_ParseDisplayName since the
1792 * signature and position in the vtable matches our unknown object type.
1794 hRet = IParseDisplayName_ParseDisplayName((LPPARSEDISPLAYNAME)lpUnkInner,
1795 lpArg1, lpArg2, lpArg3, lpArg4);
1796 IUnknown_Release(lpUnkInner);
1799 return hRet;
1802 /*************************************************************************
1803 * @ [SHLWAPI.192]
1805 * Get a sub-menu from a menu item.
1807 * PARAMS
1808 * hMenu [I] Menu to get sub-menu from
1809 * uID [I] ID of menu item containing sub-menu
1811 * RETURNS
1812 * The sub-menu of the item, or a NULL handle if any parameters are invalid.
1814 HMENU WINAPI SHGetMenuFromID(HMENU hMenu, UINT uID)
1816 MENUITEMINFOW mi;
1818 TRACE("(%p,%u)\n", hMenu, uID);
1820 mi.cbSize = sizeof(mi);
1821 mi.fMask = MIIM_SUBMENU;
1823 if (!GetMenuItemInfoW(hMenu, uID, FALSE, &mi))
1824 return NULL;
1826 return mi.hSubMenu;
1829 /*************************************************************************
1830 * @ [SHLWAPI.193]
1832 * Get the color depth of the primary display.
1834 * PARAMS
1835 * None.
1837 * RETURNS
1838 * The color depth of the primary display.
1840 DWORD WINAPI SHGetCurColorRes(void)
1842 HDC hdc;
1843 DWORD ret;
1845 TRACE("()\n");
1847 hdc = GetDC(0);
1848 ret = GetDeviceCaps(hdc, BITSPIXEL) * GetDeviceCaps(hdc, PLANES);
1849 ReleaseDC(0, hdc);
1850 return ret;
1853 /*************************************************************************
1854 * @ [SHLWAPI.194]
1856 * Wait for a message to arrive, with a timeout.
1858 * PARAMS
1859 * hand [I] Handle to query
1860 * dwTimeout [I] Timeout in ticks or INFINITE to never timeout
1862 * RETURNS
1863 * STATUS_TIMEOUT if no message is received before dwTimeout ticks passes.
1864 * Otherwise returns the value from MsgWaitForMultipleObjectsEx when a
1865 * message is available.
1867 DWORD WINAPI SHWaitForSendMessageThread(HANDLE hand, DWORD dwTimeout)
1869 DWORD dwEndTicks = GetTickCount() + dwTimeout;
1870 DWORD dwRet;
1872 while ((dwRet = MsgWaitForMultipleObjectsEx(1, &hand, dwTimeout, QS_SENDMESSAGE, 0)) == 1)
1874 MSG msg;
1876 PeekMessageW(&msg, NULL, 0, 0, PM_NOREMOVE);
1878 if (dwTimeout != INFINITE)
1880 if ((int)(dwTimeout = dwEndTicks - GetTickCount()) <= 0)
1881 return WAIT_TIMEOUT;
1885 return dwRet;
1888 /*************************************************************************
1889 * @ [SHLWAPI.195]
1891 * Determine if a shell folder can be expanded.
1893 * PARAMS
1894 * lpFolder [I] Parent folder containing the object to test.
1895 * pidl [I] Id of the object to test.
1897 * RETURNS
1898 * Success: S_OK, if the object is expandable, S_FALSE otherwise.
1899 * Failure: E_INVALIDARG, if any argument is invalid.
1901 * NOTES
1902 * If the object to be tested does not expose the IQueryInfo() interface it
1903 * will not be identified as an expandable folder.
1905 HRESULT WINAPI SHIsExpandableFolder(LPSHELLFOLDER lpFolder, LPCITEMIDLIST pidl)
1907 HRESULT hRet = E_INVALIDARG;
1908 IQueryInfo *lpInfo;
1910 if (lpFolder && pidl)
1912 hRet = IShellFolder_GetUIObjectOf(lpFolder, NULL, 1, &pidl, &IID_IQueryInfo,
1913 NULL, (void**)&lpInfo);
1914 if (FAILED(hRet))
1915 hRet = S_FALSE; /* Doesn't expose IQueryInfo */
1916 else
1918 DWORD dwFlags = 0;
1920 /* MSDN states of IQueryInfo_GetInfoFlags() that "This method is not
1921 * currently used". Really? You wouldn't be holding out on me would you?
1923 hRet = IQueryInfo_GetInfoFlags(lpInfo, &dwFlags);
1925 if (SUCCEEDED(hRet))
1927 /* 0x2 is an undocumented flag apparently indicating expandability */
1928 hRet = dwFlags & 0x2 ? S_OK : S_FALSE;
1931 IQueryInfo_Release(lpInfo);
1934 return hRet;
1937 /*************************************************************************
1938 * @ [SHLWAPI.197]
1940 * Blank out a region of text by drawing the background only.
1942 * PARAMS
1943 * hDC [I] Device context to draw in
1944 * pRect [I] Area to draw in
1945 * cRef [I] Color to draw in
1947 * RETURNS
1948 * Nothing.
1950 DWORD WINAPI SHFillRectClr(HDC hDC, LPCRECT pRect, COLORREF cRef)
1952 COLORREF cOldColor = SetBkColor(hDC, cRef);
1953 ExtTextOutA(hDC, 0, 0, ETO_OPAQUE, pRect, 0, 0, 0);
1954 SetBkColor(hDC, cOldColor);
1955 return 0;
1958 /*************************************************************************
1959 * @ [SHLWAPI.198]
1961 * Return the value associated with a key in a map.
1963 * PARAMS
1964 * lpKeys [I] A list of keys of length iLen
1965 * lpValues [I] A list of values associated with lpKeys, of length iLen
1966 * iLen [I] Length of both lpKeys and lpValues
1967 * iKey [I] The key value to look up in lpKeys
1969 * RETURNS
1970 * The value in lpValues associated with iKey, or -1 if iKey is not
1971 * found in lpKeys.
1973 * NOTES
1974 * - If two elements in the map share the same key, this function returns
1975 * the value closest to the start of the map
1976 * - The native version of this function crashes if lpKeys or lpValues is NULL.
1978 int WINAPI SHSearchMapInt(const int *lpKeys, const int *lpValues, int iLen, int iKey)
1980 if (lpKeys && lpValues)
1982 int i = 0;
1984 while (i < iLen)
1986 if (lpKeys[i] == iKey)
1987 return lpValues[i]; /* Found */
1988 i++;
1991 return -1; /* Not found */
1995 /*************************************************************************
1996 * @ [SHLWAPI.199]
1998 * Copy an interface pointer
2000 * PARAMS
2001 * lppDest [O] Destination for copy
2002 * lpUnknown [I] Source for copy
2004 * RETURNS
2005 * Nothing.
2007 VOID WINAPI IUnknown_Set(IUnknown **lppDest, IUnknown *lpUnknown)
2009 TRACE("(%p,%p)\n", lppDest, lpUnknown);
2011 if (lppDest)
2012 IUnknown_AtomicRelease(lppDest); /* Release existing interface */
2014 if (lpUnknown)
2016 /* Copy */
2017 IUnknown_AddRef(lpUnknown);
2018 *lppDest = lpUnknown;
2022 /*************************************************************************
2023 * @ [SHLWAPI.200]
2026 HRESULT WINAPI MayQSForward(IUnknown* lpUnknown, PVOID lpReserved,
2027 REFGUID riidCmdGrp, ULONG cCmds,
2028 OLECMD *prgCmds, OLECMDTEXT* pCmdText)
2030 FIXME("(%p,%p,%p,%d,%p,%p) - stub\n",
2031 lpUnknown, lpReserved, riidCmdGrp, cCmds, prgCmds, pCmdText);
2033 /* FIXME: Calls IsQSForward & IUnknown_QueryStatus */
2034 return DRAGDROP_E_NOTREGISTERED;
2037 /*************************************************************************
2038 * @ [SHLWAPI.201]
2041 HRESULT WINAPI MayExecForward(IUnknown* lpUnknown, INT iUnk, REFGUID pguidCmdGroup,
2042 DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn,
2043 VARIANT* pvaOut)
2045 FIXME("(%p,%d,%p,%d,%d,%p,%p) - stub!\n", lpUnknown, iUnk, pguidCmdGroup,
2046 nCmdID, nCmdexecopt, pvaIn, pvaOut);
2047 return DRAGDROP_E_NOTREGISTERED;
2050 /*************************************************************************
2051 * @ [SHLWAPI.202]
2054 HRESULT WINAPI IsQSForward(REFGUID pguidCmdGroup,ULONG cCmds, OLECMD *prgCmds)
2056 FIXME("(%p,%d,%p) - stub!\n", pguidCmdGroup, cCmds, prgCmds);
2057 return DRAGDROP_E_NOTREGISTERED;
2060 /*************************************************************************
2061 * @ [SHLWAPI.204]
2063 * Determine if a window is not a child of another window.
2065 * PARAMS
2066 * hParent [I] Suspected parent window
2067 * hChild [I] Suspected child window
2069 * RETURNS
2070 * TRUE: If hChild is a child window of hParent
2071 * FALSE: If hChild is not a child window of hParent, or they are equal
2073 BOOL WINAPI SHIsChildOrSelf(HWND hParent, HWND hChild)
2075 TRACE("(%p,%p)\n", hParent, hChild);
2077 if (!hParent || !hChild)
2078 return TRUE;
2079 else if(hParent == hChild)
2080 return FALSE;
2081 return !IsChild(hParent, hChild);
2084 /*************************************************************************
2085 * FDSA functions. Manage a dynamic array of fixed size memory blocks.
2088 typedef struct
2090 DWORD num_items; /* Number of elements inserted */
2091 void *mem; /* Ptr to array */
2092 DWORD blocks_alloced; /* Number of elements allocated */
2093 BYTE inc; /* Number of elements to grow by when we need to expand */
2094 BYTE block_size; /* Size in bytes of an element */
2095 BYTE flags; /* Flags */
2096 } FDSA_info;
2098 #define FDSA_FLAG_INTERNAL_ALLOC 0x01 /* When set we have allocated mem internally */
2100 /*************************************************************************
2101 * @ [SHLWAPI.208]
2103 * Initialize an FDSA array.
2105 BOOL WINAPI FDSA_Initialize(DWORD block_size, DWORD inc, FDSA_info *info, void *mem,
2106 DWORD init_blocks)
2108 TRACE("(0x%08x 0x%08x %p %p 0x%08x)\n", block_size, inc, info, mem, init_blocks);
2110 if(inc == 0)
2111 inc = 1;
2113 if(mem)
2114 memset(mem, 0, block_size * init_blocks);
2116 info->num_items = 0;
2117 info->inc = inc;
2118 info->mem = mem;
2119 info->blocks_alloced = init_blocks;
2120 info->block_size = block_size;
2121 info->flags = 0;
2123 return TRUE;
2126 /*************************************************************************
2127 * @ [SHLWAPI.209]
2129 * Destroy an FDSA array
2131 BOOL WINAPI FDSA_Destroy(FDSA_info *info)
2133 TRACE("(%p)\n", info);
2135 if(info->flags & FDSA_FLAG_INTERNAL_ALLOC)
2137 HeapFree(GetProcessHeap(), 0, info->mem);
2138 return FALSE;
2141 return TRUE;
2144 /*************************************************************************
2145 * @ [SHLWAPI.210]
2147 * Insert element into an FDSA array
2149 DWORD WINAPI FDSA_InsertItem(FDSA_info *info, DWORD where, const void *block)
2151 TRACE("(%p 0x%08x %p)\n", info, where, block);
2152 if(where > info->num_items)
2153 where = info->num_items;
2155 if(info->num_items >= info->blocks_alloced)
2157 DWORD size = (info->blocks_alloced + info->inc) * info->block_size;
2158 if(info->flags & 0x1)
2159 info->mem = HeapReAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, info->mem, size);
2160 else
2162 void *old_mem = info->mem;
2163 info->mem = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, size);
2164 memcpy(info->mem, old_mem, info->blocks_alloced * info->block_size);
2166 info->blocks_alloced += info->inc;
2167 info->flags |= 0x1;
2170 if(where < info->num_items)
2172 memmove((char*)info->mem + (where + 1) * info->block_size,
2173 (char*)info->mem + where * info->block_size,
2174 (info->num_items - where) * info->block_size);
2176 memcpy((char*)info->mem + where * info->block_size, block, info->block_size);
2178 info->num_items++;
2179 return where;
2182 /*************************************************************************
2183 * @ [SHLWAPI.211]
2185 * Delete an element from an FDSA array.
2187 BOOL WINAPI FDSA_DeleteItem(FDSA_info *info, DWORD where)
2189 TRACE("(%p 0x%08x)\n", info, where);
2191 if(where >= info->num_items)
2192 return FALSE;
2194 if(where < info->num_items - 1)
2196 memmove((char*)info->mem + where * info->block_size,
2197 (char*)info->mem + (where + 1) * info->block_size,
2198 (info->num_items - where - 1) * info->block_size);
2200 memset((char*)info->mem + (info->num_items - 1) * info->block_size,
2201 0, info->block_size);
2202 info->num_items--;
2203 return TRUE;
2207 typedef struct {
2208 REFIID refid;
2209 DWORD indx;
2210 } IFACE_INDEX_TBL;
2212 /*************************************************************************
2213 * @ [SHLWAPI.219]
2215 * Call IUnknown_QueryInterface() on a table of objects.
2217 * RETURNS
2218 * Success: S_OK.
2219 * Failure: E_POINTER or E_NOINTERFACE.
2221 HRESULT WINAPI QISearch(
2222 LPVOID w, /* [in] Table of interfaces */
2223 IFACE_INDEX_TBL *x, /* [in] Array of REFIIDs and indexes into the table */
2224 REFIID riid, /* [in] REFIID to get interface for */
2225 LPVOID *ppv) /* [out] Destination for interface pointer */
2227 HRESULT ret;
2228 IUnknown *a_vtbl;
2229 IFACE_INDEX_TBL *xmove;
2231 TRACE("(%p %p %s %p)\n", w,x,debugstr_guid(riid),ppv);
2232 if (ppv) {
2233 xmove = x;
2234 while (xmove->refid) {
2235 TRACE("trying (indx %d) %s\n", xmove->indx, debugstr_guid(xmove->refid));
2236 if (IsEqualIID(riid, xmove->refid)) {
2237 a_vtbl = (IUnknown*)(xmove->indx + (LPBYTE)w);
2238 TRACE("matched, returning (%p)\n", a_vtbl);
2239 *ppv = (LPVOID)a_vtbl;
2240 IUnknown_AddRef(a_vtbl);
2241 return S_OK;
2243 xmove++;
2246 if (IsEqualIID(riid, &IID_IUnknown)) {
2247 a_vtbl = (IUnknown*)(x->indx + (LPBYTE)w);
2248 TRACE("returning first for IUnknown (%p)\n", a_vtbl);
2249 *ppv = (LPVOID)a_vtbl;
2250 IUnknown_AddRef(a_vtbl);
2251 return S_OK;
2253 *ppv = 0;
2254 ret = E_NOINTERFACE;
2255 } else
2256 ret = E_POINTER;
2258 TRACE("-- 0x%08x\n", ret);
2259 return ret;
2262 /*************************************************************************
2263 * @ [SHLWAPI.220]
2265 * Set the Font for a window and the "PropDlgFont" property of the parent window.
2267 * PARAMS
2268 * hWnd [I] Parent Window to set the property
2269 * id [I] Index of child Window to set the Font
2271 * RETURNS
2272 * Success: S_OK
2275 HRESULT WINAPI SHSetDefaultDialogFont(HWND hWnd, INT id)
2277 FIXME("(%p, %d) stub\n", hWnd, id);
2278 return S_OK;
2281 /*************************************************************************
2282 * @ [SHLWAPI.221]
2284 * Remove the "PropDlgFont" property from a window.
2286 * PARAMS
2287 * hWnd [I] Window to remove the property from
2289 * RETURNS
2290 * A handle to the removed property, or NULL if it did not exist.
2292 HANDLE WINAPI SHRemoveDefaultDialogFont(HWND hWnd)
2294 HANDLE hProp;
2296 TRACE("(%p)\n", hWnd);
2298 hProp = GetPropA(hWnd, "PropDlgFont");
2300 if(hProp)
2302 DeleteObject(hProp);
2303 hProp = RemovePropA(hWnd, "PropDlgFont");
2305 return hProp;
2308 /*************************************************************************
2309 * @ [SHLWAPI.236]
2311 * Load the in-process server of a given GUID.
2313 * PARAMS
2314 * refiid [I] GUID of the server to load.
2316 * RETURNS
2317 * Success: A handle to the loaded server dll.
2318 * Failure: A NULL handle.
2320 HMODULE WINAPI SHPinDllOfCLSID(REFIID refiid)
2322 HKEY newkey;
2323 DWORD type, count;
2324 CHAR value[MAX_PATH], string[MAX_PATH];
2326 strcpy(string, "CLSID\\");
2327 SHStringFromGUIDA(refiid, string + 6, sizeof(string)/sizeof(char) - 6);
2328 strcat(string, "\\InProcServer32");
2330 count = MAX_PATH;
2331 RegOpenKeyExA(HKEY_CLASSES_ROOT, string, 0, 1, &newkey);
2332 RegQueryValueExA(newkey, 0, 0, &type, (PBYTE)value, &count);
2333 RegCloseKey(newkey);
2334 return LoadLibraryExA(value, 0, 0);
2337 /*************************************************************************
2338 * @ [SHLWAPI.237]
2340 * Unicode version of SHLWAPI_183.
2342 DWORD WINAPI SHRegisterClassW(WNDCLASSW * lpWndClass)
2344 WNDCLASSW WndClass;
2346 TRACE("(%p %s)\n",lpWndClass->hInstance, debugstr_w(lpWndClass->lpszClassName));
2348 if (GetClassInfoW(lpWndClass->hInstance, lpWndClass->lpszClassName, &WndClass))
2349 return TRUE;
2350 return RegisterClassW(lpWndClass);
2353 /*************************************************************************
2354 * @ [SHLWAPI.238]
2356 * Unregister a list of classes.
2358 * PARAMS
2359 * hInst [I] Application instance that registered the classes
2360 * lppClasses [I] List of class names
2361 * iCount [I] Number of names in lppClasses
2363 * RETURNS
2364 * Nothing.
2366 void WINAPI SHUnregisterClassesA(HINSTANCE hInst, LPCSTR *lppClasses, INT iCount)
2368 WNDCLASSA WndClass;
2370 TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2372 while (iCount > 0)
2374 if (GetClassInfoA(hInst, *lppClasses, &WndClass))
2375 UnregisterClassA(*lppClasses, hInst);
2376 lppClasses++;
2377 iCount--;
2381 /*************************************************************************
2382 * @ [SHLWAPI.239]
2384 * Unicode version of SHUnregisterClassesA.
2386 void WINAPI SHUnregisterClassesW(HINSTANCE hInst, LPCWSTR *lppClasses, INT iCount)
2388 WNDCLASSW WndClass;
2390 TRACE("(%p,%p,%d)\n", hInst, lppClasses, iCount);
2392 while (iCount > 0)
2394 if (GetClassInfoW(hInst, *lppClasses, &WndClass))
2395 UnregisterClassW(*lppClasses, hInst);
2396 lppClasses++;
2397 iCount--;
2401 /*************************************************************************
2402 * @ [SHLWAPI.240]
2404 * Call The correct (Ascii/Unicode) default window procedure for a window.
2406 * PARAMS
2407 * hWnd [I] Window to call the default procedure for
2408 * uMessage [I] Message ID
2409 * wParam [I] WPARAM of message
2410 * lParam [I] LPARAM of message
2412 * RETURNS
2413 * The result of calling DefWindowProcA() or DefWindowProcW().
2415 LRESULT CALLBACK SHDefWindowProc(HWND hWnd, UINT uMessage, WPARAM wParam, LPARAM lParam)
2417 if (IsWindowUnicode(hWnd))
2418 return DefWindowProcW(hWnd, uMessage, wParam, lParam);
2419 return DefWindowProcA(hWnd, uMessage, wParam, lParam);
2422 /*************************************************************************
2423 * @ [SHLWAPI.256]
2425 HRESULT WINAPI IUnknown_GetSite(LPUNKNOWN lpUnknown, REFIID iid, PVOID *lppSite)
2427 HRESULT hRet = E_INVALIDARG;
2428 LPOBJECTWITHSITE lpSite = NULL;
2430 TRACE("(%p,%s,%p)\n", lpUnknown, debugstr_guid(iid), lppSite);
2432 if (lpUnknown && iid && lppSite)
2434 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IObjectWithSite,
2435 (void**)&lpSite);
2436 if (SUCCEEDED(hRet) && lpSite)
2438 hRet = IObjectWithSite_GetSite(lpSite, iid, lppSite);
2439 IObjectWithSite_Release(lpSite);
2442 return hRet;
2445 /*************************************************************************
2446 * @ [SHLWAPI.257]
2448 * Create a worker window using CreateWindowExA().
2450 * PARAMS
2451 * wndProc [I] Window procedure
2452 * hWndParent [I] Parent window
2453 * dwExStyle [I] Extra style flags
2454 * dwStyle [I] Style flags
2455 * hMenu [I] Window menu
2456 * z [I] Unknown
2458 * RETURNS
2459 * Success: The window handle of the newly created window.
2460 * Failure: 0.
2462 HWND WINAPI SHCreateWorkerWindowA(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2463 DWORD dwStyle, HMENU hMenu, LONG z)
2465 static const char szClass[] = "WorkerA";
2466 WNDCLASSA wc;
2467 HWND hWnd;
2469 TRACE("(0x%08x,%p,0x%08x,0x%08x,%p,0x%08x)\n",
2470 wndProc, hWndParent, dwExStyle, dwStyle, hMenu, z);
2472 /* Create Window class */
2473 wc.style = 0;
2474 wc.lpfnWndProc = DefWindowProcA;
2475 wc.cbClsExtra = 0;
2476 wc.cbWndExtra = 4;
2477 wc.hInstance = shlwapi_hInstance;
2478 wc.hIcon = NULL;
2479 wc.hCursor = LoadCursorA(NULL, (LPSTR)IDC_ARROW);
2480 wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2481 wc.lpszMenuName = NULL;
2482 wc.lpszClassName = szClass;
2484 SHRegisterClassA(&wc); /* Register class */
2486 /* FIXME: Set extra bits in dwExStyle */
2488 hWnd = CreateWindowExA(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2489 hWndParent, hMenu, shlwapi_hInstance, 0);
2490 if (hWnd)
2492 SetWindowLongPtrW(hWnd, DWLP_MSGRESULT, z);
2494 if (wndProc)
2495 SetWindowLongPtrA(hWnd, GWLP_WNDPROC, wndProc);
2497 return hWnd;
2500 typedef struct tagPOLICYDATA
2502 DWORD policy; /* flags value passed to SHRestricted */
2503 LPCWSTR appstr; /* application str such as "Explorer" */
2504 LPCWSTR keystr; /* name of the actual registry key / policy */
2505 } POLICYDATA, *LPPOLICYDATA;
2507 #define SHELL_NO_POLICY 0xffffffff
2509 /* default shell policy registry key */
2510 static const WCHAR strRegistryPolicyW[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o',
2511 's','o','f','t','\\','W','i','n','d','o','w','s','\\',
2512 'C','u','r','r','e','n','t','V','e','r','s','i','o','n',
2513 '\\','P','o','l','i','c','i','e','s',0};
2515 /*************************************************************************
2516 * @ [SHLWAPI.271]
2518 * Retrieve a policy value from the registry.
2520 * PARAMS
2521 * lpSubKey [I] registry key name
2522 * lpSubName [I] subname of registry key
2523 * lpValue [I] value name of registry value
2525 * RETURNS
2526 * the value associated with the registry key or 0 if not found
2528 DWORD WINAPI SHGetRestriction(LPCWSTR lpSubKey, LPCWSTR lpSubName, LPCWSTR lpValue)
2530 DWORD retval, datsize = sizeof(retval);
2531 HKEY hKey;
2533 if (!lpSubKey)
2534 lpSubKey = strRegistryPolicyW;
2536 retval = RegOpenKeyW(HKEY_LOCAL_MACHINE, lpSubKey, &hKey);
2537 if (retval != ERROR_SUCCESS)
2538 retval = RegOpenKeyW(HKEY_CURRENT_USER, lpSubKey, &hKey);
2539 if (retval != ERROR_SUCCESS)
2540 return 0;
2542 SHGetValueW(hKey, lpSubName, lpValue, NULL, (LPBYTE)&retval, &datsize);
2543 RegCloseKey(hKey);
2544 return retval;
2547 /*************************************************************************
2548 * @ [SHLWAPI.266]
2550 * Helper function to retrieve the possibly cached value for a specific policy
2552 * PARAMS
2553 * policy [I] The policy to look for
2554 * initial [I] Main registry key to open, if NULL use default
2555 * polTable [I] Table of known policies, 0 terminated
2556 * polArr [I] Cache array of policy values
2558 * RETURNS
2559 * The retrieved policy value or 0 if not successful
2561 * NOTES
2562 * This function is used by the native SHRestricted function to search for the
2563 * policy and cache it once retrieved. The current Wine implementation uses a
2564 * different POLICYDATA structure and implements a similar algorithm adapted to
2565 * that structure.
2567 DWORD WINAPI SHRestrictionLookup(
2568 DWORD policy,
2569 LPCWSTR initial,
2570 LPPOLICYDATA polTable,
2571 LPDWORD polArr)
2573 TRACE("(0x%08x %s %p %p)\n", policy, debugstr_w(initial), polTable, polArr);
2575 if (!polTable || !polArr)
2576 return 0;
2578 for (;polTable->policy; polTable++, polArr++)
2580 if (policy == polTable->policy)
2582 /* we have a known policy */
2584 /* check if this policy has been cached */
2585 if (*polArr == SHELL_NO_POLICY)
2586 *polArr = SHGetRestriction(initial, polTable->appstr, polTable->keystr);
2587 return *polArr;
2590 /* we don't know this policy, return 0 */
2591 TRACE("unknown policy: (%08x)\n", policy);
2592 return 0;
2595 /*************************************************************************
2596 * @ [SHLWAPI.267]
2598 * Get an interface from an object.
2600 * RETURNS
2601 * Success: S_OK. ppv contains the requested interface.
2602 * Failure: An HRESULT error code.
2604 * NOTES
2605 * This QueryInterface asks the inner object for an interface. In case
2606 * of aggregation this request would be forwarded by the inner to the
2607 * outer object. This function asks the inner object directly for the
2608 * interface circumventing the forwarding to the outer object.
2610 HRESULT WINAPI SHWeakQueryInterface(
2611 IUnknown * pUnk, /* [in] Outer object */
2612 IUnknown * pInner, /* [in] Inner object */
2613 IID * riid, /* [in] Interface GUID to query for */
2614 LPVOID* ppv) /* [out] Destination for queried interface */
2616 HRESULT hret = E_NOINTERFACE;
2617 TRACE("(pUnk=%p pInner=%p\n\tIID: %s %p)\n",pUnk,pInner,debugstr_guid(riid), ppv);
2619 *ppv = NULL;
2620 if(pUnk && pInner) {
2621 hret = IUnknown_QueryInterface(pInner, riid, (LPVOID*)ppv);
2622 if (SUCCEEDED(hret)) IUnknown_Release(pUnk);
2624 TRACE("-- 0x%08x\n", hret);
2625 return hret;
2628 /*************************************************************************
2629 * @ [SHLWAPI.268]
2631 * Move a reference from one interface to another.
2633 * PARAMS
2634 * lpDest [O] Destination to receive the reference
2635 * lppUnknown [O] Source to give up the reference to lpDest
2637 * RETURNS
2638 * Nothing.
2640 VOID WINAPI SHWeakReleaseInterface(IUnknown *lpDest, IUnknown **lppUnknown)
2642 TRACE("(%p,%p)\n", lpDest, lppUnknown);
2644 if (*lppUnknown)
2646 /* Copy Reference*/
2647 IUnknown_AddRef(lpDest);
2648 IUnknown_AtomicRelease(lppUnknown); /* Release existing interface */
2652 /*************************************************************************
2653 * @ [SHLWAPI.269]
2655 * Convert an ASCII string of a CLSID into a CLSID.
2657 * PARAMS
2658 * idstr [I] String representing a CLSID in registry format
2659 * id [O] Destination for the converted CLSID
2661 * RETURNS
2662 * Success: TRUE. id contains the converted CLSID.
2663 * Failure: FALSE.
2665 BOOL WINAPI GUIDFromStringA(LPCSTR idstr, CLSID *id)
2667 WCHAR wClsid[40];
2668 MultiByteToWideChar(CP_ACP, 0, idstr, -1, wClsid, sizeof(wClsid)/sizeof(WCHAR));
2669 return SUCCEEDED(CLSIDFromString(wClsid, id));
2672 /*************************************************************************
2673 * @ [SHLWAPI.270]
2675 * Unicode version of GUIDFromStringA.
2677 BOOL WINAPI GUIDFromStringW(LPCWSTR idstr, CLSID *id)
2679 return SUCCEEDED(CLSIDFromString((LPOLESTR)idstr, id));
2682 /*************************************************************************
2683 * @ [SHLWAPI.276]
2685 * Determine if the browser is integrated into the shell, and set a registry
2686 * key accordingly.
2688 * PARAMS
2689 * None.
2691 * RETURNS
2692 * 1, If the browser is not integrated.
2693 * 2, If the browser is integrated.
2695 * NOTES
2696 * The key "HKLM\Software\Microsoft\Internet Explorer\IntegratedBrowser" is
2697 * either set to TRUE, or removed depending on whether the browser is deemed
2698 * to be integrated.
2700 DWORD WINAPI WhichPlatform(void)
2702 static const char szIntegratedBrowser[] = "IntegratedBrowser";
2703 static DWORD dwState = 0;
2704 HKEY hKey;
2705 DWORD dwRet, dwData, dwSize;
2706 HMODULE hshell32;
2708 if (dwState)
2709 return dwState;
2711 /* If shell32 exports DllGetVersion(), the browser is integrated */
2712 dwState = 1;
2713 hshell32 = LoadLibraryA("shell32.dll");
2714 if (hshell32)
2716 FARPROC pDllGetVersion;
2717 pDllGetVersion = GetProcAddress(hshell32, "DllGetVersion");
2718 dwState = pDllGetVersion ? 2 : 1;
2719 FreeLibrary(hshell32);
2722 /* Set or delete the key accordingly */
2723 dwRet = RegOpenKeyExA(HKEY_LOCAL_MACHINE,
2724 "Software\\Microsoft\\Internet Explorer", 0,
2725 KEY_ALL_ACCESS, &hKey);
2726 if (!dwRet)
2728 dwRet = RegQueryValueExA(hKey, szIntegratedBrowser, 0, 0,
2729 (LPBYTE)&dwData, &dwSize);
2731 if (!dwRet && dwState == 1)
2733 /* Value exists but browser is not integrated */
2734 RegDeleteValueA(hKey, szIntegratedBrowser);
2736 else if (dwRet && dwState == 2)
2738 /* Browser is integrated but value does not exist */
2739 dwData = TRUE;
2740 RegSetValueExA(hKey, szIntegratedBrowser, 0, REG_DWORD,
2741 (LPBYTE)&dwData, sizeof(dwData));
2743 RegCloseKey(hKey);
2745 return dwState;
2748 /*************************************************************************
2749 * @ [SHLWAPI.278]
2751 * Unicode version of SHCreateWorkerWindowA.
2753 HWND WINAPI SHCreateWorkerWindowW(LONG wndProc, HWND hWndParent, DWORD dwExStyle,
2754 DWORD dwStyle, HMENU hMenu, LONG z)
2756 static const WCHAR szClass[] = { 'W', 'o', 'r', 'k', 'e', 'r', 'W', '\0' };
2757 WNDCLASSW wc;
2758 HWND hWnd;
2760 TRACE("(0x%08x,%p,0x%08x,0x%08x,%p,0x%08x)\n",
2761 wndProc, hWndParent, dwExStyle, dwStyle, hMenu, z);
2763 /* If our OS is natively ASCII, use the ASCII version */
2764 if (!(GetVersion() & 0x80000000)) /* NT */
2765 return SHCreateWorkerWindowA(wndProc, hWndParent, dwExStyle, dwStyle, hMenu, z);
2767 /* Create Window class */
2768 wc.style = 0;
2769 wc.lpfnWndProc = DefWindowProcW;
2770 wc.cbClsExtra = 0;
2771 wc.cbWndExtra = 4;
2772 wc.hInstance = shlwapi_hInstance;
2773 wc.hIcon = NULL;
2774 wc.hCursor = LoadCursorW(NULL, (LPWSTR)IDC_ARROW);
2775 wc.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
2776 wc.lpszMenuName = NULL;
2777 wc.lpszClassName = szClass;
2779 SHRegisterClassW(&wc); /* Register class */
2781 /* FIXME: Set extra bits in dwExStyle */
2783 hWnd = CreateWindowExW(dwExStyle, szClass, 0, dwStyle, 0, 0, 0, 0,
2784 hWndParent, hMenu, shlwapi_hInstance, 0);
2785 if (hWnd)
2787 SetWindowLongPtrW(hWnd, DWLP_MSGRESULT, z);
2789 if (wndProc)
2790 SetWindowLongPtrW(hWnd, GWLP_WNDPROC, wndProc);
2792 return hWnd;
2795 /*************************************************************************
2796 * @ [SHLWAPI.279]
2798 * Get and show a context menu from a shell folder.
2800 * PARAMS
2801 * hWnd [I] Window displaying the shell folder
2802 * lpFolder [I] IShellFolder interface
2803 * lpApidl [I] Id for the particular folder desired
2805 * RETURNS
2806 * Success: S_OK.
2807 * Failure: An HRESULT error code indicating the error.
2809 HRESULT WINAPI SHInvokeDefaultCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl)
2811 return SHInvokeCommand(hWnd, lpFolder, lpApidl, FALSE);
2814 /*************************************************************************
2815 * @ [SHLWAPI.281]
2817 * _SHPackDispParamsV
2819 HRESULT WINAPI SHPackDispParamsV(DISPPARAMS *params, VARIANTARG *args, UINT cnt, ms_va_list valist)
2821 VARIANTARG *iter;
2823 TRACE("(%p %p %u ...)\n", params, args, cnt);
2825 params->rgvarg = args;
2826 params->rgdispidNamedArgs = NULL;
2827 params->cArgs = cnt;
2828 params->cNamedArgs = 0;
2830 iter = args+cnt;
2832 while(iter-- > args) {
2833 V_VT(iter) = ms_va_arg(valist, enum VARENUM);
2835 TRACE("vt=%d\n", V_VT(iter));
2837 if(V_VT(iter) & VT_BYREF) {
2838 V_BYREF(iter) = ms_va_arg(valist, LPVOID);
2839 } else {
2840 switch(V_VT(iter)) {
2841 case VT_I4:
2842 V_I4(iter) = ms_va_arg(valist, LONG);
2843 break;
2844 case VT_BSTR:
2845 V_BSTR(iter) = ms_va_arg(valist, BSTR);
2846 break;
2847 case VT_DISPATCH:
2848 V_DISPATCH(iter) = ms_va_arg(valist, IDispatch*);
2849 break;
2850 case VT_BOOL:
2851 V_BOOL(iter) = ms_va_arg(valist, int);
2852 break;
2853 case VT_UNKNOWN:
2854 V_UNKNOWN(iter) = ms_va_arg(valist, IUnknown*);
2855 break;
2856 default:
2857 V_VT(iter) = VT_I4;
2858 V_I4(iter) = ms_va_arg(valist, LONG);
2863 return S_OK;
2866 /*************************************************************************
2867 * @ [SHLWAPI.282]
2869 * SHPackDispParams
2871 HRESULT WINAPIV SHPackDispParams(DISPPARAMS *params, VARIANTARG *args, UINT cnt, ...)
2873 ms_va_list valist;
2874 HRESULT hres;
2876 ms_va_start(valist, cnt);
2878 hres = SHPackDispParamsV(params, args, cnt, valist);
2880 ms_va_end(valist);
2881 return hres;
2884 /*************************************************************************
2885 * SHLWAPI_InvokeByIID
2887 * This helper function calls IDispatch::Invoke for each sink
2888 * which implements given iid or IDispatch.
2891 static HRESULT SHLWAPI_InvokeByIID(
2892 IConnectionPoint* iCP,
2893 REFIID iid,
2894 DISPID dispId,
2895 DISPPARAMS* dispParams)
2897 IEnumConnections *enumerator;
2898 CONNECTDATA rgcd;
2900 HRESULT result = IConnectionPoint_EnumConnections(iCP, &enumerator);
2901 if (FAILED(result))
2902 return result;
2904 while(IEnumConnections_Next(enumerator, 1, &rgcd, NULL)==S_OK)
2906 IDispatch *dispIface;
2907 if (SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, iid, (LPVOID*)&dispIface)) ||
2908 SUCCEEDED(IUnknown_QueryInterface(rgcd.pUnk, &IID_IDispatch, (LPVOID*)&dispIface)))
2910 IDispatch_Invoke(dispIface, dispId, &IID_NULL, 0, DISPATCH_METHOD, dispParams, NULL, NULL, NULL);
2911 IDispatch_Release(dispIface);
2915 IEnumConnections_Release(enumerator);
2917 return S_OK;
2920 /*************************************************************************
2921 * @ [SHLWAPI.284]
2923 * IConnectionPoint_SimpleInvoke
2925 HRESULT WINAPI IConnectionPoint_SimpleInvoke(
2926 IConnectionPoint* iCP,
2927 DISPID dispId,
2928 DISPPARAMS* dispParams)
2930 IID iid;
2931 HRESULT result;
2933 TRACE("(%p)->(0x%x %p)\n",iCP,dispId,dispParams);
2935 result = IConnectionPoint_GetConnectionInterface(iCP, &iid);
2936 if (SUCCEEDED(result))
2937 result = SHLWAPI_InvokeByIID(iCP, &iid, dispId, dispParams);
2939 return result;
2942 /*************************************************************************
2943 * @ [SHLWAPI.285]
2945 * Notify an IConnectionPoint object of changes.
2947 * PARAMS
2948 * lpCP [I] Object to notify
2949 * dispID [I]
2951 * RETURNS
2952 * Success: S_OK.
2953 * Failure: E_NOINTERFACE, if lpCP is NULL or does not support the
2954 * IConnectionPoint interface.
2956 HRESULT WINAPI IConnectionPoint_OnChanged(IConnectionPoint* lpCP, DISPID dispID)
2958 IEnumConnections *lpEnum;
2959 HRESULT hRet = E_NOINTERFACE;
2961 TRACE("(%p,0x%8X)\n", lpCP, dispID);
2963 /* Get an enumerator for the connections */
2964 if (lpCP)
2965 hRet = IConnectionPoint_EnumConnections(lpCP, &lpEnum);
2967 if (SUCCEEDED(hRet))
2969 IPropertyNotifySink *lpSink;
2970 CONNECTDATA connData;
2971 ULONG ulFetched;
2973 /* Call OnChanged() for every notify sink in the connection point */
2974 while (IEnumConnections_Next(lpEnum, 1, &connData, &ulFetched) == S_OK)
2976 if (SUCCEEDED(IUnknown_QueryInterface(connData.pUnk, &IID_IPropertyNotifySink, (void**)&lpSink)) &&
2977 lpSink)
2979 IPropertyNotifySink_OnChanged(lpSink, dispID);
2980 IPropertyNotifySink_Release(lpSink);
2982 IUnknown_Release(connData.pUnk);
2985 IEnumConnections_Release(lpEnum);
2987 return hRet;
2990 /*************************************************************************
2991 * @ [SHLWAPI.286]
2993 * IUnknown_CPContainerInvokeParam
2995 HRESULT WINAPIV IUnknown_CPContainerInvokeParam(
2996 IUnknown *container,
2997 REFIID riid,
2998 DISPID dispId,
2999 VARIANTARG* buffer,
3000 DWORD cParams, ...)
3002 HRESULT result;
3003 IConnectionPoint *iCP;
3004 IConnectionPointContainer *iCPC;
3005 DISPPARAMS dispParams = {buffer, NULL, cParams, 0};
3006 ms_va_list valist;
3008 if (!container)
3009 return E_NOINTERFACE;
3011 result = IUnknown_QueryInterface(container, &IID_IConnectionPointContainer,(LPVOID*) &iCPC);
3012 if (FAILED(result))
3013 return result;
3015 result = IConnectionPointContainer_FindConnectionPoint(iCPC, riid, &iCP);
3016 IConnectionPointContainer_Release(iCPC);
3017 if(FAILED(result))
3018 return result;
3020 ms_va_start(valist, cParams);
3021 SHPackDispParamsV(&dispParams, buffer, cParams, valist);
3022 ms_va_end(valist);
3024 result = SHLWAPI_InvokeByIID(iCP, riid, dispId, &dispParams);
3025 IConnectionPoint_Release(iCP);
3027 return result;
3030 /*************************************************************************
3031 * @ [SHLWAPI.287]
3033 * Notify an IConnectionPointContainer object of changes.
3035 * PARAMS
3036 * lpUnknown [I] Object to notify
3037 * dispID [I]
3039 * RETURNS
3040 * Success: S_OK.
3041 * Failure: E_NOINTERFACE, if lpUnknown is NULL or does not support the
3042 * IConnectionPointContainer interface.
3044 HRESULT WINAPI IUnknown_CPContainerOnChanged(IUnknown *lpUnknown, DISPID dispID)
3046 IConnectionPointContainer* lpCPC = NULL;
3047 HRESULT hRet = E_NOINTERFACE;
3049 TRACE("(%p,0x%8X)\n", lpUnknown, dispID);
3051 if (lpUnknown)
3052 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IConnectionPointContainer, (void**)&lpCPC);
3054 if (SUCCEEDED(hRet))
3056 IConnectionPoint* lpCP;
3058 hRet = IConnectionPointContainer_FindConnectionPoint(lpCPC, &IID_IPropertyNotifySink, &lpCP);
3059 IConnectionPointContainer_Release(lpCPC);
3061 hRet = IConnectionPoint_OnChanged(lpCP, dispID);
3062 IConnectionPoint_Release(lpCP);
3064 return hRet;
3067 /*************************************************************************
3068 * @ [SHLWAPI.289]
3070 * See PlaySoundW.
3072 BOOL WINAPI PlaySoundWrapW(LPCWSTR pszSound, HMODULE hmod, DWORD fdwSound)
3074 return PlaySoundW(pszSound, hmod, fdwSound);
3077 /*************************************************************************
3078 * @ [SHLWAPI.294]
3080 BOOL WINAPI SHGetIniStringW(LPCWSTR str1, LPCWSTR str2, LPWSTR pStr, DWORD some_len, LPCWSTR lpStr2)
3082 FIXME("(%s,%s,%p,%08x,%s): stub!\n", debugstr_w(str1), debugstr_w(str2),
3083 pStr, some_len, debugstr_w(lpStr2));
3084 return TRUE;
3087 /*************************************************************************
3088 * @ [SHLWAPI.295]
3090 * Called by ICQ2000b install via SHDOCVW:
3091 * str1: "InternetShortcut"
3092 * x: some unknown pointer
3093 * str2: "http://free.aol.com/tryaolfree/index.adp?139269"
3094 * str3: "C:\\WINDOWS\\Desktop.new2\\Free AOL & Unlimited Internet.url"
3096 * In short: this one maybe creates a desktop link :-)
3098 BOOL WINAPI SHSetIniStringW(LPWSTR str1, LPVOID x, LPWSTR str2, LPWSTR str3)
3100 FIXME("(%s, %p, %s, %s), stub.\n", debugstr_w(str1), x, debugstr_w(str2), debugstr_w(str3));
3101 return TRUE;
3104 /*************************************************************************
3105 * @ [SHLWAPI.313]
3107 * See SHGetFileInfoW.
3109 DWORD WINAPI SHGetFileInfoWrapW(LPCWSTR path, DWORD dwFileAttributes,
3110 SHFILEINFOW *psfi, UINT sizeofpsfi, UINT flags)
3112 return SHGetFileInfoW(path, dwFileAttributes, psfi, sizeofpsfi, flags);
3115 /*************************************************************************
3116 * @ [SHLWAPI.318]
3118 * See DragQueryFileW.
3120 UINT WINAPI DragQueryFileWrapW(HDROP hDrop, UINT lFile, LPWSTR lpszFile, UINT lLength)
3122 return DragQueryFileW(hDrop, lFile, lpszFile, lLength);
3125 /*************************************************************************
3126 * @ [SHLWAPI.333]
3128 * See SHBrowseForFolderW.
3130 LPITEMIDLIST WINAPI SHBrowseForFolderWrapW(LPBROWSEINFOW lpBi)
3132 return SHBrowseForFolderW(lpBi);
3135 /*************************************************************************
3136 * @ [SHLWAPI.334]
3138 * See SHGetPathFromIDListW.
3140 BOOL WINAPI SHGetPathFromIDListWrapW(LPCITEMIDLIST pidl,LPWSTR pszPath)
3142 return SHGetPathFromIDListW(pidl, pszPath);
3145 /*************************************************************************
3146 * @ [SHLWAPI.335]
3148 * See ShellExecuteExW.
3150 BOOL WINAPI ShellExecuteExWrapW(LPSHELLEXECUTEINFOW lpExecInfo)
3152 return ShellExecuteExW(lpExecInfo);
3155 /*************************************************************************
3156 * @ [SHLWAPI.336]
3158 * See SHFileOperationW.
3160 INT WINAPI SHFileOperationWrapW(LPSHFILEOPSTRUCTW lpFileOp)
3162 return SHFileOperationW(lpFileOp);
3165 /*************************************************************************
3166 * @ [SHLWAPI.342]
3169 PVOID WINAPI SHInterlockedCompareExchange( PVOID *dest, PVOID xchg, PVOID compare )
3171 return InterlockedCompareExchangePointer( dest, xchg, compare );
3174 /*************************************************************************
3175 * @ [SHLWAPI.350]
3177 * See GetFileVersionInfoSizeW.
3179 DWORD WINAPI GetFileVersionInfoSizeWrapW( LPCWSTR filename, LPDWORD handle )
3181 return GetFileVersionInfoSizeW( filename, handle );
3184 /*************************************************************************
3185 * @ [SHLWAPI.351]
3187 * See GetFileVersionInfoW.
3189 BOOL WINAPI GetFileVersionInfoWrapW( LPCWSTR filename, DWORD handle,
3190 DWORD datasize, LPVOID data )
3192 return GetFileVersionInfoW( filename, handle, datasize, data );
3195 /*************************************************************************
3196 * @ [SHLWAPI.352]
3198 * See VerQueryValueW.
3200 WORD WINAPI VerQueryValueWrapW( LPVOID pBlock, LPCWSTR lpSubBlock,
3201 LPVOID *lplpBuffer, UINT *puLen )
3203 return VerQueryValueW( pBlock, lpSubBlock, lplpBuffer, puLen );
3206 #define IsIface(type) SUCCEEDED((hRet = IUnknown_QueryInterface(lpUnknown, &IID_##type, (void**)&lpObj)))
3207 #define IShellBrowser_EnableModeless IShellBrowser_EnableModelessSB
3208 #define EnableModeless(type) type##_EnableModeless((type*)lpObj, bModeless)
3210 /*************************************************************************
3211 * @ [SHLWAPI.355]
3213 * Change the modality of a shell object.
3215 * PARAMS
3216 * lpUnknown [I] Object to make modeless
3217 * bModeless [I] TRUE=Make modeless, FALSE=Make modal
3219 * RETURNS
3220 * Success: S_OK. The modality lpUnknown is changed.
3221 * Failure: An HRESULT error code indicating the error.
3223 * NOTES
3224 * lpUnknown must support the IOleInPlaceFrame interface, the
3225 * IInternetSecurityMgrSite interface, the IShellBrowser interface
3226 * the IDocHostUIHandler interface, or the IOleInPlaceActiveObject interface,
3227 * or this call will fail.
3229 HRESULT WINAPI IUnknown_EnableModeless(IUnknown *lpUnknown, BOOL bModeless)
3231 IUnknown *lpObj;
3232 HRESULT hRet;
3234 TRACE("(%p,%d)\n", lpUnknown, bModeless);
3236 if (!lpUnknown)
3237 return E_FAIL;
3239 if (IsIface(IOleInPlaceActiveObject))
3240 EnableModeless(IOleInPlaceActiveObject);
3241 else if (IsIface(IOleInPlaceFrame))
3242 EnableModeless(IOleInPlaceFrame);
3243 else if (IsIface(IShellBrowser))
3244 EnableModeless(IShellBrowser);
3245 else if (IsIface(IInternetSecurityMgrSite))
3246 EnableModeless(IInternetSecurityMgrSite);
3247 else if (IsIface(IDocHostUIHandler))
3248 EnableModeless(IDocHostUIHandler);
3249 else
3250 return hRet;
3252 IUnknown_Release(lpObj);
3253 return S_OK;
3256 /*************************************************************************
3257 * @ [SHLWAPI.357]
3259 * See SHGetNewLinkInfoW.
3261 BOOL WINAPI SHGetNewLinkInfoWrapW(LPCWSTR pszLinkTo, LPCWSTR pszDir, LPWSTR pszName,
3262 BOOL *pfMustCopy, UINT uFlags)
3264 return SHGetNewLinkInfoW(pszLinkTo, pszDir, pszName, pfMustCopy, uFlags);
3267 /*************************************************************************
3268 * @ [SHLWAPI.358]
3270 * See SHDefExtractIconW.
3272 UINT WINAPI SHDefExtractIconWrapW(LPCWSTR pszIconFile, int iIndex, UINT uFlags, HICON* phiconLarge,
3273 HICON* phiconSmall, UINT nIconSize)
3275 return SHDefExtractIconW(pszIconFile, iIndex, uFlags, phiconLarge, phiconSmall, nIconSize);
3278 /*************************************************************************
3279 * @ [SHLWAPI.363]
3281 * Get and show a context menu from a shell folder.
3283 * PARAMS
3284 * hWnd [I] Window displaying the shell folder
3285 * lpFolder [I] IShellFolder interface
3286 * lpApidl [I] Id for the particular folder desired
3287 * bInvokeDefault [I] Whether to invoke the default menu item
3289 * RETURNS
3290 * Success: S_OK. If bInvokeDefault is TRUE, the default menu action was
3291 * executed.
3292 * Failure: An HRESULT error code indicating the error.
3294 HRESULT WINAPI SHInvokeCommand(HWND hWnd, IShellFolder* lpFolder, LPCITEMIDLIST lpApidl, BOOL bInvokeDefault)
3296 IContextMenu *iContext;
3297 HRESULT hRet = E_FAIL;
3299 TRACE("(%p,%p,%p,%d)\n", hWnd, lpFolder, lpApidl, bInvokeDefault);
3301 if (!lpFolder)
3302 return hRet;
3304 /* Get the context menu from the shell folder */
3305 hRet = IShellFolder_GetUIObjectOf(lpFolder, hWnd, 1, &lpApidl,
3306 &IID_IContextMenu, 0, (void**)&iContext);
3307 if (SUCCEEDED(hRet))
3309 HMENU hMenu;
3310 if ((hMenu = CreatePopupMenu()))
3312 HRESULT hQuery;
3313 DWORD dwDefaultId = 0;
3315 /* Add the context menu entries to the popup */
3316 hQuery = IContextMenu_QueryContextMenu(iContext, hMenu, 0, 1, 0x7FFF,
3317 bInvokeDefault ? CMF_NORMAL : CMF_DEFAULTONLY);
3319 if (SUCCEEDED(hQuery))
3321 if (bInvokeDefault &&
3322 (dwDefaultId = GetMenuDefaultItem(hMenu, 0, 0)) != 0xFFFFFFFF)
3324 CMINVOKECOMMANDINFO cmIci;
3325 /* Invoke the default item */
3326 memset(&cmIci,0,sizeof(cmIci));
3327 cmIci.cbSize = sizeof(cmIci);
3328 cmIci.fMask = CMIC_MASK_ASYNCOK;
3329 cmIci.hwnd = hWnd;
3330 cmIci.lpVerb = MAKEINTRESOURCEA(dwDefaultId);
3331 cmIci.nShow = SW_SCROLLCHILDREN;
3333 hRet = IContextMenu_InvokeCommand(iContext, &cmIci);
3336 DestroyMenu(hMenu);
3338 IContextMenu_Release(iContext);
3340 return hRet;
3343 /*************************************************************************
3344 * @ [SHLWAPI.370]
3346 * See ExtractIconW.
3348 HICON WINAPI ExtractIconWrapW(HINSTANCE hInstance, LPCWSTR lpszExeFileName,
3349 UINT nIconIndex)
3351 return ExtractIconW(hInstance, lpszExeFileName, nIconIndex);
3354 /*************************************************************************
3355 * @ [SHLWAPI.377]
3357 * Load a library from the directory of a particular process.
3359 * PARAMS
3360 * new_mod [I] Library name
3361 * inst_hwnd [I] Module whose directory is to be used
3362 * dwCrossCodePage [I] Should be FALSE (currently ignored)
3364 * RETURNS
3365 * Success: A handle to the loaded module
3366 * Failure: A NULL handle.
3368 HMODULE WINAPI MLLoadLibraryA(LPCSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3370 /* FIXME: Native appears to do DPA_Create and a DPA_InsertPtr for
3371 * each call here.
3372 * FIXME: Native shows calls to:
3373 * SHRegGetUSValue for "Software\Microsoft\Internet Explorer\International"
3374 * CheckVersion
3375 * RegOpenKeyExA for "HKLM\Software\Microsoft\Internet Explorer"
3376 * RegQueryValueExA for "LPKInstalled"
3377 * RegCloseKey
3378 * RegOpenKeyExA for "HKCU\Software\Microsoft\Internet Explorer\International"
3379 * RegQueryValueExA for "ResourceLocale"
3380 * RegCloseKey
3381 * RegOpenKeyExA for "HKLM\Software\Microsoft\Active Setup\Installed Components\{guid}"
3382 * RegQueryValueExA for "Locale"
3383 * RegCloseKey
3384 * and then tests the Locale ("en" for me).
3385 * code below
3386 * after the code then a DPA_Create (first time) and DPA_InsertPtr are done.
3388 CHAR mod_path[2*MAX_PATH];
3389 LPSTR ptr;
3390 DWORD len;
3392 FIXME("(%s,%p,%d) semi-stub!\n", debugstr_a(new_mod), inst_hwnd, dwCrossCodePage);
3393 len = GetModuleFileNameA(inst_hwnd, mod_path, sizeof(mod_path));
3394 if (!len || len >= sizeof(mod_path)) return NULL;
3396 ptr = strrchr(mod_path, '\\');
3397 if (ptr) {
3398 strcpy(ptr+1, new_mod);
3399 TRACE("loading %s\n", debugstr_a(mod_path));
3400 return LoadLibraryA(mod_path);
3402 return NULL;
3405 /*************************************************************************
3406 * @ [SHLWAPI.378]
3408 * Unicode version of MLLoadLibraryA.
3410 HMODULE WINAPI MLLoadLibraryW(LPCWSTR new_mod, HMODULE inst_hwnd, DWORD dwCrossCodePage)
3412 WCHAR mod_path[2*MAX_PATH];
3413 LPWSTR ptr;
3414 DWORD len;
3416 FIXME("(%s,%p,%d) semi-stub!\n", debugstr_w(new_mod), inst_hwnd, dwCrossCodePage);
3417 len = GetModuleFileNameW(inst_hwnd, mod_path, sizeof(mod_path) / sizeof(WCHAR));
3418 if (!len || len >= sizeof(mod_path) / sizeof(WCHAR)) return NULL;
3420 ptr = strrchrW(mod_path, '\\');
3421 if (ptr) {
3422 strcpyW(ptr+1, new_mod);
3423 TRACE("loading %s\n", debugstr_w(mod_path));
3424 return LoadLibraryW(mod_path);
3426 return NULL;
3429 /*************************************************************************
3430 * ColorAdjustLuma [SHLWAPI.@]
3432 * Adjust the luminosity of a color
3434 * PARAMS
3435 * cRGB [I] RGB value to convert
3436 * dwLuma [I] Luma adjustment
3437 * bUnknown [I] Unknown
3439 * RETURNS
3440 * The adjusted RGB color.
3442 COLORREF WINAPI ColorAdjustLuma(COLORREF cRGB, int dwLuma, BOOL bUnknown)
3444 TRACE("(0x%8x,%d,%d)\n", cRGB, dwLuma, bUnknown);
3446 if (dwLuma)
3448 WORD wH, wL, wS;
3450 ColorRGBToHLS(cRGB, &wH, &wL, &wS);
3452 FIXME("Ignoring luma adjustment\n");
3454 /* FIXME: The adjustment is not linear */
3456 cRGB = ColorHLSToRGB(wH, wL, wS);
3458 return cRGB;
3461 /*************************************************************************
3462 * @ [SHLWAPI.389]
3464 * See GetSaveFileNameW.
3466 BOOL WINAPI GetSaveFileNameWrapW(LPOPENFILENAMEW ofn)
3468 return GetSaveFileNameW(ofn);
3471 /*************************************************************************
3472 * @ [SHLWAPI.390]
3474 * See WNetRestoreConnectionW.
3476 DWORD WINAPI WNetRestoreConnectionWrapW(HWND hwndOwner, LPWSTR lpszDevice)
3478 return WNetRestoreConnectionW(hwndOwner, lpszDevice);
3481 /*************************************************************************
3482 * @ [SHLWAPI.391]
3484 * See WNetGetLastErrorW.
3486 DWORD WINAPI WNetGetLastErrorWrapW(LPDWORD lpError, LPWSTR lpErrorBuf, DWORD nErrorBufSize,
3487 LPWSTR lpNameBuf, DWORD nNameBufSize)
3489 return WNetGetLastErrorW(lpError, lpErrorBuf, nErrorBufSize, lpNameBuf, nNameBufSize);
3492 /*************************************************************************
3493 * @ [SHLWAPI.401]
3495 * See PageSetupDlgW.
3497 BOOL WINAPI PageSetupDlgWrapW(LPPAGESETUPDLGW pagedlg)
3499 return PageSetupDlgW(pagedlg);
3502 /*************************************************************************
3503 * @ [SHLWAPI.402]
3505 * See PrintDlgW.
3507 BOOL WINAPI PrintDlgWrapW(LPPRINTDLGW printdlg)
3509 return PrintDlgW(printdlg);
3512 /*************************************************************************
3513 * @ [SHLWAPI.403]
3515 * See GetOpenFileNameW.
3517 BOOL WINAPI GetOpenFileNameWrapW(LPOPENFILENAMEW ofn)
3519 return GetOpenFileNameW(ofn);
3522 /*************************************************************************
3523 * @ [SHLWAPI.404]
3525 HRESULT WINAPI SHIShellFolder_EnumObjects(LPSHELLFOLDER lpFolder, HWND hwnd, SHCONTF flags, IEnumIDList **ppenum)
3527 IPersist *persist;
3528 HRESULT hr;
3530 hr = IShellFolder_QueryInterface(lpFolder, &IID_IPersist, (LPVOID)&persist);
3531 if(SUCCEEDED(hr))
3533 CLSID clsid;
3534 hr = IPersist_GetClassID(persist, &clsid);
3535 if(SUCCEEDED(hr))
3537 if(IsEqualCLSID(&clsid, &CLSID_ShellFSFolder))
3538 hr = IShellFolder_EnumObjects(lpFolder, hwnd, flags, ppenum);
3539 else
3540 hr = E_FAIL;
3542 IPersist_Release(persist);
3544 return hr;
3547 /* INTERNAL: Map from HLS color space to RGB */
3548 static WORD ConvertHue(int wHue, WORD wMid1, WORD wMid2)
3550 wHue = wHue > 240 ? wHue - 240 : wHue < 0 ? wHue + 240 : wHue;
3552 if (wHue > 160)
3553 return wMid1;
3554 else if (wHue > 120)
3555 wHue = 160 - wHue;
3556 else if (wHue > 40)
3557 return wMid2;
3559 return ((wHue * (wMid2 - wMid1) + 20) / 40) + wMid1;
3562 /* Convert to RGB and scale into RGB range (0..255) */
3563 #define GET_RGB(h) (ConvertHue(h, wMid1, wMid2) * 255 + 120) / 240
3565 /*************************************************************************
3566 * ColorHLSToRGB [SHLWAPI.@]
3568 * Convert from hls color space into an rgb COLORREF.
3570 * PARAMS
3571 * wHue [I] Hue amount
3572 * wLuminosity [I] Luminosity amount
3573 * wSaturation [I] Saturation amount
3575 * RETURNS
3576 * A COLORREF representing the converted color.
3578 * NOTES
3579 * Input hls values are constrained to the range (0..240).
3581 COLORREF WINAPI ColorHLSToRGB(WORD wHue, WORD wLuminosity, WORD wSaturation)
3583 WORD wRed;
3585 if (wSaturation)
3587 WORD wGreen, wBlue, wMid1, wMid2;
3589 if (wLuminosity > 120)
3590 wMid2 = wSaturation + wLuminosity - (wSaturation * wLuminosity + 120) / 240;
3591 else
3592 wMid2 = ((wSaturation + 240) * wLuminosity + 120) / 240;
3594 wMid1 = wLuminosity * 2 - wMid2;
3596 wRed = GET_RGB(wHue + 80);
3597 wGreen = GET_RGB(wHue);
3598 wBlue = GET_RGB(wHue - 80);
3600 return RGB(wRed, wGreen, wBlue);
3603 wRed = wLuminosity * 255 / 240;
3604 return RGB(wRed, wRed, wRed);
3607 /*************************************************************************
3608 * @ [SHLWAPI.413]
3610 * Get the current docking status of the system.
3612 * PARAMS
3613 * dwFlags [I] DOCKINFO_ flags from "winbase.h", unused
3615 * RETURNS
3616 * One of DOCKINFO_UNDOCKED, DOCKINFO_UNDOCKED, or 0 if the system is not
3617 * a notebook.
3619 DWORD WINAPI SHGetMachineInfo(DWORD dwFlags)
3621 HW_PROFILE_INFOA hwInfo;
3623 TRACE("(0x%08x)\n", dwFlags);
3625 GetCurrentHwProfileA(&hwInfo);
3626 switch (hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED))
3628 case DOCKINFO_DOCKED:
3629 case DOCKINFO_UNDOCKED:
3630 return hwInfo.dwDockInfo & (DOCKINFO_DOCKED|DOCKINFO_UNDOCKED);
3631 default:
3632 return 0;
3636 /*************************************************************************
3637 * @ [SHLWAPI.418]
3639 * Function seems to do FreeLibrary plus other things.
3641 * FIXME native shows the following calls:
3642 * RtlEnterCriticalSection
3643 * LocalFree
3644 * GetProcAddress(Comctl32??, 150L)
3645 * DPA_DeletePtr
3646 * RtlLeaveCriticalSection
3647 * followed by the FreeLibrary.
3648 * The above code may be related to .377 above.
3650 BOOL WINAPI MLFreeLibrary(HMODULE hModule)
3652 FIXME("(%p) semi-stub\n", hModule);
3653 return FreeLibrary(hModule);
3656 /*************************************************************************
3657 * @ [SHLWAPI.419]
3659 BOOL WINAPI SHFlushSFCacheWrap(void) {
3660 FIXME(": stub\n");
3661 return TRUE;
3664 /*************************************************************************
3665 * @ [SHLWAPI.429]
3666 * FIXME I have no idea what this function does or what its arguments are.
3668 BOOL WINAPI MLIsMLHInstance(HINSTANCE hInst)
3670 FIXME("(%p) stub\n", hInst);
3671 return FALSE;
3675 /*************************************************************************
3676 * @ [SHLWAPI.430]
3678 DWORD WINAPI MLSetMLHInstance(HINSTANCE hInst, HANDLE hHeap)
3680 FIXME("(%p,%p) stub\n", hInst, hHeap);
3681 return E_FAIL; /* This is what is used if shlwapi not loaded */
3684 /*************************************************************************
3685 * @ [SHLWAPI.431]
3687 DWORD WINAPI MLClearMLHInstance(DWORD x)
3689 FIXME("(0x%08x)stub\n", x);
3690 return 0xabba1247;
3693 /*************************************************************************
3694 * @ [SHLWAPI.432]
3696 * See SHSendMessageBroadcastW
3699 DWORD WINAPI SHSendMessageBroadcastA(UINT uMsg, WPARAM wParam, LPARAM lParam)
3701 return SendMessageTimeoutA(HWND_BROADCAST, uMsg, wParam, lParam,
3702 SMTO_ABORTIFHUNG, 2000, NULL);
3705 /*************************************************************************
3706 * @ [SHLWAPI.433]
3708 * A wrapper for sending Broadcast Messages to all top level Windows
3711 DWORD WINAPI SHSendMessageBroadcastW(UINT uMsg, WPARAM wParam, LPARAM lParam)
3713 return SendMessageTimeoutW(HWND_BROADCAST, uMsg, wParam, lParam,
3714 SMTO_ABORTIFHUNG, 2000, NULL);
3717 /*************************************************************************
3718 * @ [SHLWAPI.436]
3720 * Convert a Unicode string CLSID into a CLSID.
3722 * PARAMS
3723 * idstr [I] string containing a CLSID in text form
3724 * id [O] CLSID extracted from the string
3726 * RETURNS
3727 * S_OK on success or E_INVALIDARG on failure
3729 HRESULT WINAPI CLSIDFromStringWrap(LPCWSTR idstr, CLSID *id)
3731 return CLSIDFromString((LPOLESTR)idstr, id);
3734 /*************************************************************************
3735 * @ [SHLWAPI.437]
3737 * Determine if the OS supports a given feature.
3739 * PARAMS
3740 * dwFeature [I] Feature requested (undocumented)
3742 * RETURNS
3743 * TRUE If the feature is available.
3744 * FALSE If the feature is not available.
3746 BOOL WINAPI IsOS(DWORD feature)
3748 OSVERSIONINFOA osvi;
3749 DWORD platform, majorv, minorv;
3751 osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOA);
3752 if(!GetVersionExA(&osvi)) {
3753 ERR("GetVersionEx failed\n");
3754 return FALSE;
3757 majorv = osvi.dwMajorVersion;
3758 minorv = osvi.dwMinorVersion;
3759 platform = osvi.dwPlatformId;
3761 #define ISOS_RETURN(x) \
3762 TRACE("(0x%x) ret=%d\n",feature,(x)); \
3763 return (x);
3765 switch(feature) {
3766 case OS_WIN32SORGREATER:
3767 ISOS_RETURN(platform == VER_PLATFORM_WIN32s
3768 || platform == VER_PLATFORM_WIN32_WINDOWS)
3769 case OS_NT:
3770 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3771 case OS_WIN95ORGREATER:
3772 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS)
3773 case OS_NT4ORGREATER:
3774 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 4)
3775 case OS_WIN2000ORGREATER_ALT:
3776 case OS_WIN2000ORGREATER:
3777 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3778 case OS_WIN98ORGREATER:
3779 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 10)
3780 case OS_WIN98_GOLD:
3781 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 10)
3782 case OS_WIN2000PRO:
3783 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3784 case OS_WIN2000SERVER:
3785 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3786 case OS_WIN2000ADVSERVER:
3787 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3788 case OS_WIN2000DATACENTER:
3789 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3790 case OS_WIN2000TERMINAL:
3791 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && (minorv == 0 || minorv == 1))
3792 case OS_EMBEDDED:
3793 FIXME("(OS_EMBEDDED) What should we return here?\n");
3794 return FALSE;
3795 case OS_TERMINALCLIENT:
3796 FIXME("(OS_TERMINALCLIENT) What should we return here?\n");
3797 return FALSE;
3798 case OS_TERMINALREMOTEADMIN:
3799 FIXME("(OS_TERMINALREMOTEADMIN) What should we return here?\n");
3800 return FALSE;
3801 case OS_WIN95_GOLD:
3802 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv == 0)
3803 case OS_MEORGREATER:
3804 ISOS_RETURN(platform == VER_PLATFORM_WIN32_WINDOWS && minorv >= 90)
3805 case OS_XPORGREATER:
3806 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
3807 case OS_HOME:
3808 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5 && minorv >= 1)
3809 case OS_PROFESSIONAL:
3810 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3811 case OS_DATACENTER:
3812 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3813 case OS_ADVSERVER:
3814 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && majorv >= 5)
3815 case OS_SERVER:
3816 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3817 case OS_TERMINALSERVER:
3818 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3819 case OS_PERSONALTERMINALSERVER:
3820 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT && minorv >= 1 && majorv >= 5)
3821 case OS_FASTUSERSWITCHING:
3822 FIXME("(OS_FASTUSERSWITCHING) What should we return here?\n");
3823 return TRUE;
3824 case OS_WELCOMELOGONUI:
3825 FIXME("(OS_WELCOMELOGONUI) What should we return here?\n");
3826 return FALSE;
3827 case OS_DOMAINMEMBER:
3828 FIXME("(OS_DOMAINMEMBER) What should we return here?\n");
3829 return TRUE;
3830 case OS_ANYSERVER:
3831 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3832 case OS_WOW6432:
3833 FIXME("(OS_WOW6432) Should we check this?\n");
3834 return FALSE;
3835 case OS_WEBSERVER:
3836 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3837 case OS_SMALLBUSINESSSERVER:
3838 ISOS_RETURN(platform == VER_PLATFORM_WIN32_NT)
3839 case OS_TABLETPC:
3840 FIXME("(OS_TABLEPC) What should we return here?\n");
3841 return FALSE;
3842 case OS_SERVERADMINUI:
3843 FIXME("(OS_SERVERADMINUI) What should we return here?\n");
3844 return FALSE;
3845 case OS_MEDIACENTER:
3846 FIXME("(OS_MEDIACENTER) What should we return here?\n");
3847 return FALSE;
3848 case OS_APPLIANCE:
3849 FIXME("(OS_APPLIANCE) What should we return here?\n");
3850 return FALSE;
3853 #undef ISOS_RETURN
3855 WARN("(0x%x) unknown parameter\n",feature);
3857 return FALSE;
3860 /*************************************************************************
3861 * @ [SHLWAPI.439]
3863 HRESULT WINAPI SHLoadRegUIStringW(HKEY hkey, LPCWSTR value, LPWSTR buf, DWORD size)
3865 DWORD type, sz = size;
3867 if(RegQueryValueExW(hkey, value, NULL, &type, (LPBYTE)buf, &sz) != ERROR_SUCCESS)
3868 return E_FAIL;
3870 return SHLoadIndirectString(buf, buf, size, NULL);
3873 /*************************************************************************
3874 * @ [SHLWAPI.478]
3876 * Call IInputObject_TranslateAcceleratorIO() on an object.
3878 * PARAMS
3879 * lpUnknown [I] Object supporting the IInputObject interface.
3880 * lpMsg [I] Key message to be processed.
3882 * RETURNS
3883 * Success: S_OK.
3884 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
3886 HRESULT WINAPI IUnknown_TranslateAcceleratorIO(IUnknown *lpUnknown, LPMSG lpMsg)
3888 IInputObject* lpInput = NULL;
3889 HRESULT hRet = E_INVALIDARG;
3891 TRACE("(%p,%p)\n", lpUnknown, lpMsg);
3892 if (lpUnknown)
3894 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
3895 (void**)&lpInput);
3896 if (SUCCEEDED(hRet) && lpInput)
3898 hRet = IInputObject_TranslateAcceleratorIO(lpInput, lpMsg);
3899 IInputObject_Release(lpInput);
3902 return hRet;
3905 /*************************************************************************
3906 * @ [SHLWAPI.481]
3908 * Call IInputObject_HasFocusIO() on an object.
3910 * PARAMS
3911 * lpUnknown [I] Object supporting the IInputObject interface.
3913 * RETURNS
3914 * Success: S_OK, if lpUnknown is an IInputObject object and has the focus,
3915 * or S_FALSE otherwise.
3916 * Failure: An HRESULT error code, or E_INVALIDARG if lpUnknown is NULL.
3918 HRESULT WINAPI IUnknown_HasFocusIO(IUnknown *lpUnknown)
3920 IInputObject* lpInput = NULL;
3921 HRESULT hRet = E_INVALIDARG;
3923 TRACE("(%p)\n", lpUnknown);
3924 if (lpUnknown)
3926 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObject,
3927 (void**)&lpInput);
3928 if (SUCCEEDED(hRet) && lpInput)
3930 hRet = IInputObject_HasFocusIO(lpInput);
3931 IInputObject_Release(lpInput);
3934 return hRet;
3937 /*************************************************************************
3938 * ColorRGBToHLS [SHLWAPI.@]
3940 * Convert an rgb COLORREF into the hls color space.
3942 * PARAMS
3943 * cRGB [I] Source rgb value
3944 * pwHue [O] Destination for converted hue
3945 * pwLuminance [O] Destination for converted luminance
3946 * pwSaturation [O] Destination for converted saturation
3948 * RETURNS
3949 * Nothing. pwHue, pwLuminance and pwSaturation are set to the converted
3950 * values.
3952 * NOTES
3953 * Output HLS values are constrained to the range (0..240).
3954 * For Achromatic conversions, Hue is set to 160.
3956 VOID WINAPI ColorRGBToHLS(COLORREF cRGB, LPWORD pwHue,
3957 LPWORD pwLuminance, LPWORD pwSaturation)
3959 int wR, wG, wB, wMax, wMin, wHue, wLuminosity, wSaturation;
3961 TRACE("(%08x,%p,%p,%p)\n", cRGB, pwHue, pwLuminance, pwSaturation);
3963 wR = GetRValue(cRGB);
3964 wG = GetGValue(cRGB);
3965 wB = GetBValue(cRGB);
3967 wMax = max(wR, max(wG, wB));
3968 wMin = min(wR, min(wG, wB));
3970 /* Luminosity */
3971 wLuminosity = ((wMax + wMin) * 240 + 255) / 510;
3973 if (wMax == wMin)
3975 /* Achromatic case */
3976 wSaturation = 0;
3977 /* Hue is now unrepresentable, but this is what native returns... */
3978 wHue = 160;
3980 else
3982 /* Chromatic case */
3983 int wDelta = wMax - wMin, wRNorm, wGNorm, wBNorm;
3985 /* Saturation */
3986 if (wLuminosity <= 120)
3987 wSaturation = ((wMax + wMin)/2 + wDelta * 240) / (wMax + wMin);
3988 else
3989 wSaturation = ((510 - wMax - wMin)/2 + wDelta * 240) / (510 - wMax - wMin);
3991 /* Hue */
3992 wRNorm = (wDelta/2 + wMax * 40 - wR * 40) / wDelta;
3993 wGNorm = (wDelta/2 + wMax * 40 - wG * 40) / wDelta;
3994 wBNorm = (wDelta/2 + wMax * 40 - wB * 40) / wDelta;
3996 if (wR == wMax)
3997 wHue = wBNorm - wGNorm;
3998 else if (wG == wMax)
3999 wHue = 80 + wRNorm - wBNorm;
4000 else
4001 wHue = 160 + wGNorm - wRNorm;
4002 if (wHue < 0)
4003 wHue += 240;
4004 else if (wHue > 240)
4005 wHue -= 240;
4007 if (pwHue)
4008 *pwHue = wHue;
4009 if (pwLuminance)
4010 *pwLuminance = wLuminosity;
4011 if (pwSaturation)
4012 *pwSaturation = wSaturation;
4015 /*************************************************************************
4016 * SHCreateShellPalette [SHLWAPI.@]
4018 HPALETTE WINAPI SHCreateShellPalette(HDC hdc)
4020 FIXME("stub\n");
4021 return CreateHalftonePalette(hdc);
4024 /*************************************************************************
4025 * SHGetInverseCMAP (SHLWAPI.@)
4027 * Get an inverse color map table.
4029 * PARAMS
4030 * lpCmap [O] Destination for color map
4031 * dwSize [I] Size of memory pointed to by lpCmap
4033 * RETURNS
4034 * Success: S_OK.
4035 * Failure: E_POINTER, If lpCmap is invalid.
4036 * E_INVALIDARG, If dwFlags is invalid
4037 * E_OUTOFMEMORY, If there is no memory available
4039 * NOTES
4040 * dwSize may only be CMAP_PTR_SIZE (4) or CMAP_SIZE (8192).
4041 * If dwSize = CMAP_PTR_SIZE, *lpCmap is set to the address of this DLL's
4042 * internal CMap.
4043 * If dwSize = CMAP_SIZE, lpCmap is filled with a copy of the data from
4044 * this DLL's internal CMap.
4046 HRESULT WINAPI SHGetInverseCMAP(LPDWORD dest, DWORD dwSize)
4048 if (dwSize == 4) {
4049 FIXME(" - returning bogus address for SHGetInverseCMAP\n");
4050 *dest = (DWORD)0xabba1249;
4051 return 0;
4053 FIXME("(%p, %#x) stub\n", dest, dwSize);
4054 return 0;
4057 /*************************************************************************
4058 * SHIsLowMemoryMachine [SHLWAPI.@]
4060 * Determine if the current computer has low memory.
4062 * PARAMS
4063 * x [I] FIXME
4065 * RETURNS
4066 * TRUE if the users machine has 16 Megabytes of memory or less,
4067 * FALSE otherwise.
4069 BOOL WINAPI SHIsLowMemoryMachine (DWORD x)
4071 FIXME("(0x%08x) stub\n", x);
4072 return FALSE;
4075 /*************************************************************************
4076 * GetMenuPosFromID [SHLWAPI.@]
4078 * Return the position of a menu item from its Id.
4080 * PARAMS
4081 * hMenu [I] Menu containing the item
4082 * wID [I] Id of the menu item
4084 * RETURNS
4085 * Success: The index of the menu item in hMenu.
4086 * Failure: -1, If the item is not found.
4088 INT WINAPI GetMenuPosFromID(HMENU hMenu, UINT wID)
4090 MENUITEMINFOW mi;
4091 INT nCount = GetMenuItemCount(hMenu), nIter = 0;
4093 while (nIter < nCount)
4095 mi.cbSize = sizeof(mi);
4096 mi.fMask = MIIM_ID;
4097 if (GetMenuItemInfoW(hMenu, nIter, TRUE, &mi) && mi.wID == wID)
4098 return nIter;
4099 nIter++;
4101 return -1;
4104 /*************************************************************************
4105 * @ [SHLWAPI.179]
4107 * Same as SHLWAPI.GetMenuPosFromID
4109 DWORD WINAPI SHMenuIndexFromID(HMENU hMenu, UINT uID)
4111 return GetMenuPosFromID(hMenu, uID);
4115 /*************************************************************************
4116 * @ [SHLWAPI.448]
4118 VOID WINAPI FixSlashesAndColonW(LPWSTR lpwstr)
4120 while (*lpwstr)
4122 if (*lpwstr == '/')
4123 *lpwstr = '\\';
4124 lpwstr++;
4129 /*************************************************************************
4130 * @ [SHLWAPI.461]
4132 DWORD WINAPI SHGetAppCompatFlags(DWORD dwUnknown)
4134 FIXME("(0x%08x) stub\n", dwUnknown);
4135 return 0;
4139 /*************************************************************************
4140 * @ [SHLWAPI.549]
4142 HRESULT WINAPI SHCoCreateInstanceAC(REFCLSID rclsid, LPUNKNOWN pUnkOuter,
4143 DWORD dwClsContext, REFIID iid, LPVOID *ppv)
4145 return CoCreateInstance(rclsid, pUnkOuter, dwClsContext, iid, ppv);
4148 /*************************************************************************
4149 * SHSkipJunction [SHLWAPI.@]
4151 * Determine if a bind context can be bound to an object
4153 * PARAMS
4154 * pbc [I] Bind context to check
4155 * pclsid [I] CLSID of object to be bound to
4157 * RETURNS
4158 * TRUE: If it is safe to bind
4159 * FALSE: If pbc is invalid or binding would not be safe
4162 BOOL WINAPI SHSkipJunction(IBindCtx *pbc, const CLSID *pclsid)
4164 static WCHAR szSkipBinding[] = { 'S','k','i','p',' ',
4165 'B','i','n','d','i','n','g',' ','C','L','S','I','D','\0' };
4166 BOOL bRet = FALSE;
4168 if (pbc)
4170 IUnknown* lpUnk;
4172 if (SUCCEEDED(IBindCtx_GetObjectParam(pbc, (LPOLESTR)szSkipBinding, &lpUnk)))
4174 CLSID clsid;
4176 if (SUCCEEDED(IUnknown_GetClassID(lpUnk, &clsid)) &&
4177 IsEqualGUID(pclsid, &clsid))
4178 bRet = TRUE;
4180 IUnknown_Release(lpUnk);
4183 return bRet;
4186 /***********************************************************************
4187 * SHGetShellKey (SHLWAPI.@)
4189 DWORD WINAPI SHGetShellKey(DWORD a, DWORD b, DWORD c)
4191 FIXME("(%x, %x, %x): stub\n", a, b, c);
4192 return 0x50;
4195 /***********************************************************************
4196 * SHQueueUserWorkItem (SHLWAPI.@)
4198 BOOL WINAPI SHQueueUserWorkItem(LPTHREAD_START_ROUTINE pfnCallback,
4199 LPVOID pContext, LONG lPriority, DWORD_PTR dwTag,
4200 DWORD_PTR *pdwId, LPCSTR pszModule, DWORD dwFlags)
4202 TRACE("(%p, %p, %d, %lx, %p, %s, %08x)\n", pfnCallback, pContext,
4203 lPriority, dwTag, pdwId, debugstr_a(pszModule), dwFlags);
4205 if(lPriority || dwTag || pdwId || pszModule || dwFlags)
4206 FIXME("Unsupported arguments\n");
4208 return QueueUserWorkItem(pfnCallback, pContext, 0);
4211 /***********************************************************************
4212 * SHSetTimerQueueTimer (SHLWAPI.263)
4214 HANDLE WINAPI SHSetTimerQueueTimer(HANDLE hQueue,
4215 WAITORTIMERCALLBACK pfnCallback, LPVOID pContext, DWORD dwDueTime,
4216 DWORD dwPeriod, LPCSTR lpszLibrary, DWORD dwFlags)
4218 HANDLE hNewTimer;
4220 /* SHSetTimerQueueTimer flags -> CreateTimerQueueTimer flags */
4221 if (dwFlags & TPS_LONGEXECTIME) {
4222 dwFlags &= ~TPS_LONGEXECTIME;
4223 dwFlags |= WT_EXECUTELONGFUNCTION;
4225 if (dwFlags & TPS_EXECUTEIO) {
4226 dwFlags &= ~TPS_EXECUTEIO;
4227 dwFlags |= WT_EXECUTEINIOTHREAD;
4230 if (!CreateTimerQueueTimer(&hNewTimer, hQueue, pfnCallback, pContext,
4231 dwDueTime, dwPeriod, dwFlags))
4232 return NULL;
4234 return hNewTimer;
4237 /***********************************************************************
4238 * IUnknown_OnFocusChangeIS (SHLWAPI.@)
4240 HRESULT WINAPI IUnknown_OnFocusChangeIS(LPUNKNOWN lpUnknown, LPUNKNOWN pFocusObject, BOOL bFocus)
4242 IInputObjectSite *pIOS = NULL;
4243 HRESULT hRet = E_INVALIDARG;
4245 TRACE("(%p, %p, %s)\n", lpUnknown, pFocusObject, bFocus ? "TRUE" : "FALSE");
4247 if (lpUnknown)
4249 hRet = IUnknown_QueryInterface(lpUnknown, &IID_IInputObjectSite,
4250 (void **)&pIOS);
4251 if (SUCCEEDED(hRet) && pIOS)
4253 hRet = IInputObjectSite_OnFocusChangeIS(pIOS, pFocusObject, bFocus);
4254 IInputObjectSite_Release(pIOS);
4257 return hRet;
4260 /***********************************************************************
4261 * SHGetValueW (SHLWAPI.@)
4263 HRESULT WINAPI SKGetValueW(DWORD a, LPWSTR b, LPWSTR c, DWORD d, DWORD e, DWORD f)
4265 FIXME("(%x, %s, %s, %x, %x, %x): stub\n", a, debugstr_w(b), debugstr_w(c), d, e, f);
4266 return E_FAIL;
4269 typedef HRESULT (WINAPI *DllGetVersion_func)(DLLVERSIONINFO *);
4271 /***********************************************************************
4272 * GetUIVersion (SHLWAPI.452)
4274 DWORD WINAPI GetUIVersion(void)
4276 static DWORD version;
4278 if (!version)
4280 DllGetVersion_func pDllGetVersion;
4281 HMODULE dll = LoadLibraryA("shell32.dll");
4282 if (!dll) return 0;
4284 pDllGetVersion = (DllGetVersion_func)GetProcAddress(dll, "DllGetVersion");
4285 if (pDllGetVersion)
4287 DLLVERSIONINFO dvi;
4288 dvi.cbSize = sizeof(DLLVERSIONINFO);
4289 if (pDllGetVersion(&dvi) == S_OK) version = dvi.dwMajorVersion;
4291 FreeLibrary( dll );
4292 if (!version) version = 3; /* old shell dlls don't have DllGetVersion */
4294 return version;
4297 /***********************************************************************
4298 * ShellMessageBoxWrapW [SHLWAPI.388]
4300 * See shell32.ShellMessageBoxW
4302 * NOTE:
4303 * shlwapi.ShellMessageBoxWrapW is a duplicate of shell32.ShellMessageBoxW
4304 * because we can't forward to it in the .spec file since it's exported by
4305 * ordinal. If you change the implementation here please update the code in
4306 * shell32 as well.
4308 INT WINAPIV ShellMessageBoxWrapW(HINSTANCE hInstance, HWND hWnd, LPCWSTR lpText,
4309 LPCWSTR lpCaption, UINT uType, ...)
4311 WCHAR szText[100], szTitle[100];
4312 LPCWSTR pszText = szText, pszTitle = szTitle;
4313 LPWSTR pszTemp;
4314 ms_va_list args;
4315 int ret;
4317 ms_va_start(args, uType);
4319 TRACE("(%p,%p,%p,%p,%08x)\n", hInstance, hWnd, lpText, lpCaption, uType);
4321 if (IS_INTRESOURCE(lpCaption))
4322 LoadStringW(hInstance, LOWORD(lpCaption), szTitle, sizeof(szTitle)/sizeof(szTitle[0]));
4323 else
4324 pszTitle = lpCaption;
4326 if (IS_INTRESOURCE(lpText))
4327 LoadStringW(hInstance, LOWORD(lpText), szText, sizeof(szText)/sizeof(szText[0]));
4328 else
4329 pszText = lpText;
4331 FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
4332 pszText, 0, 0, (LPWSTR)&pszTemp, 0, &args);
4334 ms_va_end(args);
4336 ret = MessageBoxW(hWnd, pszTemp, pszTitle, uType);
4337 LocalFree(pszTemp);
4338 return ret;
4341 HRESULT WINAPI IUnknown_QueryServiceExec(IUnknown *unk, REFIID service, REFIID clsid,
4342 DWORD x1, DWORD x2, DWORD x3, void **ppvOut)
4344 FIXME("%p %s %s %08x %08x %08x %p\n", unk,
4345 debugstr_guid(service), debugstr_guid(clsid), x1, x2, x3, ppvOut);
4346 return E_NOTIMPL;
4349 HRESULT WINAPI IUnknown_ProfferService(IUnknown *unk, void *x0, void *x1, void *x2)
4351 FIXME("%p %p %p %p\n", unk, x0, x1, x2);
4352 return E_NOTIMPL;
4355 /***********************************************************************
4356 * ZoneComputePaneSize [SHLWAPI.382]
4358 UINT WINAPI ZoneComputePaneSize(HWND hwnd)
4360 FIXME("\n");
4361 return 0x95;
4364 /***********************************************************************
4365 * SHChangeNotifyWrap [SHLWAPI.394]
4367 void WINAPI SHChangeNotifyWrap(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2)
4369 SHChangeNotify(wEventId, uFlags, dwItem1, dwItem2);
4372 typedef struct SHELL_USER_SID { /* according to MSDN this should be in shlobj.h... */
4373 SID_IDENTIFIER_AUTHORITY sidAuthority;
4374 DWORD dwUserGroupID;
4375 DWORD dwUserID;
4376 } SHELL_USER_SID, *PSHELL_USER_SID;
4378 typedef struct SHELL_USER_PERMISSION { /* ...and this should be in shlwapi.h */
4379 SHELL_USER_SID susID;
4380 DWORD dwAccessType;
4381 BOOL fInherit;
4382 DWORD dwAccessMask;
4383 DWORD dwInheritMask;
4384 DWORD dwInheritAccessMask;
4385 } SHELL_USER_PERMISSION, *PSHELL_USER_PERMISSION;
4387 /***********************************************************************
4388 * GetShellSecurityDescriptor [SHLWAPI.475]
4390 * prepares SECURITY_DESCRIPTOR from a set of ACEs
4392 * PARAMS
4393 * apUserPerm [I] array of pointers to SHELL_USER_PERMISSION structures,
4394 * each of which describes permissions to apply
4395 * cUserPerm [I] number of entries in apUserPerm array
4397 * RETURNS
4398 * success: pointer to SECURITY_DESCRIPTOR
4399 * failure: NULL
4401 * NOTES
4402 * Call should free returned descriptor with LocalFree
4404 PSECURITY_DESCRIPTOR WINAPI GetShellSecurityDescriptor(PSHELL_USER_PERMISSION *apUserPerm, int cUserPerm)
4406 PSID *sidlist;
4407 PSID cur_user = NULL;
4408 BYTE tuUser[2000];
4409 DWORD acl_size;
4410 int sid_count, i;
4411 PSECURITY_DESCRIPTOR psd = NULL;
4413 TRACE("%p %d\n", apUserPerm, cUserPerm);
4415 if (apUserPerm == NULL || cUserPerm <= 0)
4416 return NULL;
4418 sidlist = HeapAlloc(GetProcessHeap(), 0, cUserPerm * sizeof(PSID));
4419 if (!sidlist)
4420 return NULL;
4422 acl_size = sizeof(ACL);
4424 for(sid_count = 0; sid_count < cUserPerm; sid_count++)
4426 static SHELL_USER_SID null_sid = {{SECURITY_NULL_SID_AUTHORITY}, 0, 0};
4427 PSHELL_USER_PERMISSION perm = apUserPerm[sid_count];
4428 PSHELL_USER_SID sid = &perm->susID;
4429 PSID pSid;
4430 BOOL ret = TRUE;
4432 if (!memcmp((void*)sid, (void*)&null_sid, sizeof(SHELL_USER_SID)))
4433 { /* current user's SID */
4434 if (!cur_user)
4436 HANDLE Token;
4437 DWORD bufsize = sizeof(tuUser);
4439 ret = OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY, &Token);
4440 if (ret)
4442 ret = GetTokenInformation(Token, TokenUser, (void*)tuUser, bufsize, &bufsize );
4443 if (ret)
4444 cur_user = ((PTOKEN_USER)tuUser)->User.Sid;
4445 CloseHandle(Token);
4448 pSid = cur_user;
4449 } else if (sid->dwUserID==0) /* one sub-authority */
4450 ret = AllocateAndInitializeSid(&sid->sidAuthority, 1, sid->dwUserGroupID, 0,
4451 0, 0, 0, 0, 0, 0, &pSid);
4452 else
4453 ret = AllocateAndInitializeSid(&sid->sidAuthority, 2, sid->dwUserGroupID, sid->dwUserID,
4454 0, 0, 0, 0, 0, 0, &pSid);
4455 if (!ret)
4456 goto free_sids;
4458 sidlist[sid_count] = pSid;
4459 /* increment acl_size (1 ACE for non-inheritable and 2 ACEs for inheritable records */
4460 acl_size += (sizeof(ACCESS_ALLOWED_ACE)-sizeof(DWORD) + GetLengthSid(pSid)) * (perm->fInherit ? 2 : 1);
4463 psd = LocalAlloc(0, sizeof(SECURITY_DESCRIPTOR) + acl_size);
4465 if (psd != NULL)
4467 PACL pAcl = (PACL)(((BYTE*)psd)+sizeof(SECURITY_DESCRIPTOR));
4469 if (!InitializeSecurityDescriptor(psd, SECURITY_DESCRIPTOR_REVISION))
4470 goto error;
4472 if (!InitializeAcl(pAcl, acl_size, ACL_REVISION))
4473 goto error;
4475 for(i = 0; i < sid_count; i++)
4477 PSHELL_USER_PERMISSION sup = apUserPerm[i];
4478 PSID sid = sidlist[i];
4480 switch(sup->dwAccessType)
4482 case ACCESS_ALLOWED_ACE_TYPE:
4483 if (!AddAccessAllowedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4484 goto error;
4485 if (sup->fInherit && !AddAccessAllowedAceEx(pAcl, ACL_REVISION,
4486 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4487 goto error;
4488 break;
4489 case ACCESS_DENIED_ACE_TYPE:
4490 if (!AddAccessDeniedAce(pAcl, ACL_REVISION, sup->dwAccessMask, sid))
4491 goto error;
4492 if (sup->fInherit && !AddAccessDeniedAceEx(pAcl, ACL_REVISION,
4493 (BYTE)sup->dwInheritMask, sup->dwInheritAccessMask, sid))
4494 goto error;
4495 break;
4496 default:
4497 goto error;
4501 if (!SetSecurityDescriptorDacl(psd, TRUE, pAcl, FALSE))
4502 goto error;
4504 goto free_sids;
4506 error:
4507 LocalFree(psd);
4508 psd = NULL;
4509 free_sids:
4510 for(i = 0; i < sid_count; i++)
4512 if (!cur_user || sidlist[i] != cur_user)
4513 FreeSid(sidlist[i]);
4515 HeapFree(GetProcessHeap(), 0, sidlist);
4517 return psd;