projects / reactos.git / blob
? search:


8836b1f565bed06917e4763608752b79213a4ae8
[reactos.git] / reactos / include / psdk / shlwapi.h
1 /*
2 * SHLWAPI.DLL functions
3 *
4 * Copyright (C) 2000 Juergen Schmied
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19 */
20
21 #ifndef __WINE_SHLWAPI_H
22 #define __WINE_SHLWAPI_H
23
24 #include <specstrings.h>
25 #include <objbase.h>
26 #include <shtypes.h>
27
28 #ifdef __cplusplus
29 extern "C" {
30 #endif /* defined(__cplusplus) */
31
32 #include <pshpack8.h>
33
34 #ifndef NO_SHLWAPI_REG
35
36 /* Registry functions */
37
38 DWORD WINAPI SHDeleteEmptyKeyA(_In_ HKEY, _In_opt_ LPCSTR);
39 DWORD WINAPI SHDeleteEmptyKeyW(_In_ HKEY, _In_opt_ LPCWSTR);
40 #define SHDeleteEmptyKey WINELIB_NAME_AW(SHDeleteEmptyKey)
41
42 DWORD WINAPI SHDeleteKeyA(_In_ HKEY, _In_opt_ LPCSTR);
43 DWORD WINAPI SHDeleteKeyW(_In_ HKEY, _In_opt_ LPCWSTR);
44 #define SHDeleteKey WINELIB_NAME_AW(SHDeleteKey)
45
46 DWORD WINAPI SHDeleteValueA(_In_ HKEY, _In_opt_ LPCSTR, _In_ LPCSTR);
47 DWORD WINAPI SHDeleteValueW(_In_ HKEY, _In_opt_ LPCWSTR, _In_ LPCWSTR);
48 #define SHDeleteValue WINELIB_NAME_AW(SHDeleteValue)
49
50 DWORD
51 WINAPI
52 SHGetValueA(
53 _In_ HKEY,
54 _In_opt_ LPCSTR,
55 _In_opt_ LPCSTR,
56 _Out_opt_ LPDWORD,
57 _Out_writes_bytes_opt_(*pcbData) LPVOID,
58 _Inout_opt_ LPDWORD pcbData);
59
60 DWORD
61 WINAPI
62 SHGetValueW(
63 _In_ HKEY,
64 _In_opt_ LPCWSTR,
65 _In_opt_ LPCWSTR,
66 _Out_opt_ LPDWORD,
67 _Out_writes_bytes_opt_(*pcbData) LPVOID,
68 _Inout_opt_ LPDWORD pcbData);
69
70 #define SHGetValue WINELIB_NAME_AW(SHGetValue)
71
72 DWORD
73 WINAPI
74 SHSetValueA(
75 _In_ HKEY,
76 _In_opt_ LPCSTR,
77 _In_opt_ LPCSTR,
78 _In_ DWORD,
79 _In_reads_bytes_opt_(cbData) LPCVOID,
80 _In_ DWORD cbData);
81
82 DWORD
83 WINAPI
84 SHSetValueW(
85 _In_ HKEY,
86 _In_opt_ LPCWSTR,
87 _In_opt_ LPCWSTR,
88 _In_ DWORD,
89 _In_reads_bytes_opt_(cbData) LPCVOID,
90 _In_ DWORD cbData);
91
92 #define SHSetValue WINELIB_NAME_AW(SHSetValue)
93
94 DWORD
95 WINAPI
96 SHQueryValueExA(
97 _In_ HKEY,
98 _In_opt_ LPCSTR,
99 _Reserved_ LPDWORD,
100 _Out_opt_ LPDWORD,
101 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
102 _Inout_opt_ LPDWORD pcbData);
103
104 DWORD
105 WINAPI
106 SHQueryValueExW(
107 _In_ HKEY,
108 _In_opt_ LPCWSTR,
109 _Reserved_ LPDWORD,
110 _Out_opt_ LPDWORD,
111 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
112 _Inout_opt_ LPDWORD pcbData);
113
114 #define SHQueryValueEx WINELIB_NAME_AW(SHQueryValueEx)
115
116 LONG
117 WINAPI
118 SHEnumKeyExA(
119 _In_ HKEY,
120 _In_ DWORD,
121 _Out_writes_(*pcchName) LPSTR,
122 _Inout_ LPDWORD pcchName);
123
124 LONG
125 WINAPI
126 SHEnumKeyExW(
127 _In_ HKEY,
128 _In_ DWORD,
129 _Out_writes_(*pcchName) LPWSTR,
130 _Inout_ LPDWORD pcchName);
131
132 #define SHEnumKeyEx WINELIB_NAME_AW(SHEnumKeyEx)
133
134 LONG
135 WINAPI
136 SHEnumValueA(
137 _In_ HKEY,
138 _In_ DWORD,
139 _Out_writes_opt_(*pcchValueName) LPSTR,
140 _Inout_opt_ LPDWORD pcchValueName,
141 _Out_opt_ LPDWORD,
142 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
143 _Inout_opt_ LPDWORD pcbData);
144
145 LONG
146 WINAPI
147 SHEnumValueW(
148 _In_ HKEY,
149 _In_ DWORD,
150 _Out_writes_opt_(*pcchValueName) LPWSTR,
151 _Inout_opt_ LPDWORD pcchValueName,
152 _Out_opt_ LPDWORD,
153 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
154 _Inout_opt_ LPDWORD pcbData);
155
156 #define SHEnumValue WINELIB_NAME_AW(SHEnumValue)
157
158 LONG
159 WINAPI
160 SHQueryInfoKeyA(
161 _In_ HKEY,
162 _Out_opt_ LPDWORD,
163 _Out_opt_ LPDWORD,
164 _Out_opt_ LPDWORD,
165 _Out_opt_ LPDWORD);
166
167 LONG
168 WINAPI
169 SHQueryInfoKeyW(
170 _In_ HKEY,
171 _Out_opt_ LPDWORD,
172 _Out_opt_ LPDWORD,
173 _Out_opt_ LPDWORD,
174 _Out_opt_ LPDWORD);
175
176 #define SHQueryInfoKey WINELIB_NAME_AW(SHQueryInfoKey)
177
178 DWORD
179 WINAPI
180 SHRegGetPathA(
181 _In_ HKEY,
182 _In_opt_ LPCSTR,
183 _In_opt_ LPCSTR,
184 _Out_writes_(MAX_PATH) LPSTR,
185 _In_ DWORD);
186
187 DWORD
188 WINAPI
189 SHRegGetPathW(
190 _In_ HKEY,
191 _In_opt_ LPCWSTR,
192 _In_opt_ LPCWSTR,
193 _Out_writes_(MAX_PATH) LPWSTR,
194 _In_ DWORD);
195
196 #define SHRegGetPath WINELIB_NAME_AW(SHRegGetPath)
197
198 DWORD
199 WINAPI
200 SHRegSetPathA(
201 _In_ HKEY,
202 _In_opt_ LPCSTR,
203 _In_opt_ LPCSTR,
204 _In_ LPCSTR,
205 _In_ DWORD);
206
207 DWORD
208 WINAPI
209 SHRegSetPathW(
210 _In_ HKEY,
211 _In_opt_ LPCWSTR,
212 _In_opt_ LPCWSTR,
213 _In_ LPCWSTR,
214 _In_ DWORD);
215
216 #define SHRegSetPath WINELIB_NAME_AW(SHRegSetPath)
217
218 DWORD
219 WINAPI
220 SHCopyKeyA(
221 _In_ HKEY,
222 _In_opt_ LPCSTR,
223 _In_ HKEY,
224 _Reserved_ DWORD);
225
226 DWORD
227 WINAPI
228 SHCopyKeyW(
229 _In_ HKEY,
230 _In_opt_ LPCWSTR,
231 _In_ HKEY,
232 _Reserved_ DWORD);
233
234 #define SHCopyKey WINELIB_NAME_AW(SHCopyKey)
235
236 HKEY WINAPI SHRegDuplicateHKey(_In_ HKEY);
237
238 /* SHRegGetValue flags */
239 typedef INT SRRF;
240
241 #define SRRF_RT_REG_NONE 0x1
242 #define SRRF_RT_REG_SZ 0x2
243 #define SRRF_RT_REG_EXPAND_SZ 0x4
244 #define SRRF_RT_REG_BINARY 0x8
245 #define SRRF_RT_REG_DWORD 0x10
246 #define SRRF_RT_REG_MULTI_SZ 0x20
247 #define SRRF_RT_REG_QWORD 0x40
248
249 #define SRRF_RT_DWORD (SRRF_RT_REG_BINARY|SRRF_RT_REG_DWORD)
250 #define SRRF_RT_QWORD (SRRF_RT_REG_BINARY|SRRF_RT_REG_QWORD)
251 #define SRRF_RT_ANY 0xffff
252
253 #define SRRF_RM_ANY 0
254 #define SRRF_RM_NORMAL 0x10000
255 #define SRRF_RM_SAFE 0x20000
256 #define SRRF_RM_SAFENETWORK 0x40000
257
258 #define SRRF_NOEXPAND 0x10000000
259 #define SRRF_ZEROONFAILURE 0x20000000
260 #define SRRF_NOVIRT 0x40000000
261
262 LSTATUS
263 WINAPI
264 SHRegGetValueA(
265 _In_ HKEY,
266 _In_opt_ LPCSTR,
267 _In_opt_ LPCSTR,
268 _In_ SRRF,
269 _Out_opt_ LPDWORD,
270 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
271 _Inout_opt_ LPDWORD pcbData);
272
273 LSTATUS
274 WINAPI
275 SHRegGetValueW(
276 _In_ HKEY,
277 _In_opt_ LPCWSTR,
278 _In_opt_ LPCWSTR,
279 _In_ SRRF,
280 _Out_opt_ LPDWORD,
281 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
282 _Inout_opt_ LPDWORD pcbData);
283
284 #define SHRegGetValue WINELIB_NAME_AW(SHRegGetValue)
285
286 /* Undocumented registry functions */
287
288 DWORD WINAPI SHDeleteOrphanKeyA(HKEY,LPCSTR);
289 DWORD WINAPI SHDeleteOrphanKeyW(HKEY,LPCWSTR);
290 #define SHDeleteOrphanKey WINELIB_NAME_AW(SHDeleteOrphanKey)
291
292
293 /* User registry functions */
294
295 typedef enum
296 {
297 SHREGDEL_DEFAULT = 0,
298 SHREGDEL_HKCU = 0x1,
299 SHREGDEL_HKLM = 0x10,
300 SHREGDEL_BOTH = SHREGDEL_HKLM | SHREGDEL_HKCU
301 } SHREGDEL_FLAGS;
302
303 typedef enum
304 {
305 SHREGENUM_DEFAULT = 0,
306 SHREGENUM_HKCU = 0x1,
307 SHREGENUM_HKLM = 0x10,
308 SHREGENUM_BOTH = SHREGENUM_HKLM | SHREGENUM_HKCU
309 } SHREGENUM_FLAGS;
310
311 #define SHREGSET_HKCU 0x1 /* Apply to HKCU if empty */
312 #define SHREGSET_FORCE_HKCU 0x2 /* Always apply to HKCU */
313 #define SHREGSET_HKLM 0x4 /* Apply to HKLM if empty */
314 #define SHREGSET_FORCE_HKLM 0x8 /* Always apply to HKLM */
315 #define SHREGSET_DEFAULT (SHREGSET_FORCE_HKCU | SHREGSET_HKLM)
316
317 typedef HANDLE HUSKEY;
318 typedef HUSKEY *PHUSKEY;
319
320 LONG
321 WINAPI
322 SHRegCreateUSKeyA(
323 _In_ LPCSTR,
324 _In_ REGSAM,
325 _In_opt_ HUSKEY,
326 _Out_ PHUSKEY,
327 _In_ DWORD);
328
329 LONG
330 WINAPI
331 SHRegCreateUSKeyW(
332 _In_ LPCWSTR,
333 _In_ REGSAM,
334 _In_opt_ HUSKEY,
335 _Out_ PHUSKEY,
336 _In_ DWORD);
337
338 #define SHRegCreateUSKey WINELIB_NAME_AW(SHRegCreateUSKey)
339
340 LONG
341 WINAPI
342 SHRegOpenUSKeyA(
343 _In_ LPCSTR,
344 _In_ REGSAM,
345 _In_opt_ HUSKEY,
346 _Out_ PHUSKEY,
347 _In_ BOOL);
348
349 LONG
350 WINAPI
351 SHRegOpenUSKeyW(
352 _In_ LPCWSTR,
353 _In_ REGSAM,
354 _In_opt_ HUSKEY,
355 _Out_ PHUSKEY,
356 _In_ BOOL);
357
358 #define SHRegOpenUSKey WINELIB_NAME_AW(SHRegOpenUSKey)
359
360 LONG
361 WINAPI
362 SHRegQueryUSValueA(
363 _In_ HUSKEY,
364 _In_opt_ LPCSTR,
365 _Inout_opt_ LPDWORD,
366 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
367 _Inout_opt_ LPDWORD pcbData,
368 _In_ BOOL,
369 _In_reads_bytes_opt_(dwDefaultDataSize) LPVOID,
370 _In_opt_ DWORD dwDefaultDataSize);
371
372 LONG
373 WINAPI
374 SHRegQueryUSValueW(
375 _In_ HUSKEY,
376 _In_opt_ LPCWSTR,
377 _Inout_opt_ LPDWORD,
378 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
379 _Inout_opt_ LPDWORD pcbData,
380 _In_ BOOL,
381 _In_reads_bytes_opt_(dwDefaultDataSize) LPVOID,
382 _In_opt_ DWORD dwDefaultDataSize);
383
384 #define SHRegQueryUSValue WINELIB_NAME_AW(SHRegQueryUSValue)
385
386 LONG
387 WINAPI
388 SHRegWriteUSValueA(
389 _In_ HUSKEY,
390 _In_ LPCSTR,
391 _In_ DWORD,
392 _In_reads_bytes_(cbData) LPVOID,
393 _In_ DWORD cbData,
394 _In_ DWORD);
395
396 LONG
397 WINAPI
398 SHRegWriteUSValueW(
399 _In_ HUSKEY,
400 _In_ LPCWSTR,
401 _In_ DWORD,
402 _In_reads_bytes_(cbData) LPVOID,
403 _In_ DWORD cbData,
404 _In_ DWORD);
405
406 #define SHRegWriteUSValue WINELIB_NAME_AW(SHRegWriteUSValue)
407
408 LONG
409 WINAPI
410 SHRegDeleteUSValueA(
411 _In_ HUSKEY,
412 _In_ LPCSTR,
413 _In_ SHREGDEL_FLAGS);
414
415 LONG
416 WINAPI
417 SHRegDeleteUSValueW(
418 _In_ HUSKEY,
419 _In_ LPCWSTR,
420 _In_ SHREGDEL_FLAGS);
421
422 #define SHRegDeleteUSValue WINELIB_NAME_AW(SHRegDeleteUSValue)
423
424 LONG
425 WINAPI
426 SHRegDeleteEmptyUSKeyA(
427 _In_ HUSKEY,
428 _In_ LPCSTR,
429 _In_ SHREGDEL_FLAGS);
430
431 LONG
432 WINAPI
433 SHRegDeleteEmptyUSKeyW(
434 _In_ HUSKEY,
435 _In_ LPCWSTR,
436 _In_ SHREGDEL_FLAGS);
437
438 #define SHRegDeleteEmptyUSKey WINELIB_NAME_AW(SHRegDeleteEmptyUSKey)
439
440 LONG
441 WINAPI
442 SHRegEnumUSKeyA(
443 _In_ HUSKEY,
444 _In_ DWORD,
445 _Out_writes_to_(*pcchName, *pcchName) LPSTR,
446 _Inout_ LPDWORD pcchName,
447 _In_ SHREGENUM_FLAGS);
448
449 LONG
450 WINAPI
451 SHRegEnumUSKeyW(
452 _In_ HUSKEY,
453 _In_ DWORD,
454 _Out_writes_to_(*pcchName, *pcchName) LPWSTR,
455 _Inout_ LPDWORD pcchName,
456 _In_ SHREGENUM_FLAGS);
457
458 #define SHRegEnumUSKey WINELIB_NAME_AW(SHRegEnumUSKey)
459
460 LONG
461 WINAPI
462 SHRegEnumUSValueA(
463 _In_ HUSKEY,
464 _In_ DWORD,
465 _Out_writes_to_(*pcchValueName, *pcchValueName) LPSTR,
466 _Inout_ LPDWORD pcchValueName,
467 _Out_opt_ LPDWORD,
468 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
469 _Inout_opt_ LPDWORD pcbData,
470 _In_ SHREGENUM_FLAGS);
471
472 LONG
473 WINAPI
474 SHRegEnumUSValueW(
475 _In_ HUSKEY,
476 _In_ DWORD,
477 _Out_writes_to_(*pcchValueName, *pcchValueName) LPWSTR,
478 _Inout_ LPDWORD pcchValueName,
479 _Out_opt_ LPDWORD,
480 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
481 _Inout_opt_ LPDWORD pcbData,
482 _In_ SHREGENUM_FLAGS);
483
484 #define SHRegEnumUSValue WINELIB_NAME_AW(SHRegEnumUSValue)
485
486 LONG
487 WINAPI
488 SHRegQueryInfoUSKeyA(
489 _In_ HUSKEY,
490 _Out_opt_ LPDWORD,
491 _Out_opt_ LPDWORD,
492 _Out_opt_ LPDWORD,
493 _Out_opt_ LPDWORD,
494 _In_ SHREGENUM_FLAGS);
495
496 LONG
497 WINAPI
498 SHRegQueryInfoUSKeyW(
499 _In_ HUSKEY,
500 _Out_opt_ LPDWORD,
501 _Out_opt_ LPDWORD,
502 _Out_opt_ LPDWORD,
503 _Out_opt_ LPDWORD,
504 _In_ SHREGENUM_FLAGS);
505
506 #define SHRegQueryInfoUSKey WINELIB_NAME_AW(SHRegQueryInfoUSKey)
507
508 LONG WINAPI SHRegCloseUSKey(_In_ HUSKEY);
509
510 LONG
511 WINAPI
512 SHRegGetUSValueA(
513 _In_ LPCSTR,
514 _In_opt_ LPCSTR,
515 _Inout_opt_ LPDWORD,
516 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
517 _Inout_opt_ LPDWORD pcbData,
518 _In_ BOOL,
519 _In_reads_bytes_opt_(dwDefaultDataSize) LPVOID,
520 _In_ DWORD dwDefaultDataSize);
521
522 LONG
523 WINAPI
524 SHRegGetUSValueW(
525 _In_ LPCWSTR,
526 _In_opt_ LPCWSTR,
527 _Inout_opt_ LPDWORD,
528 _Out_writes_bytes_to_opt_(*pcbData, *pcbData) LPVOID,
529 _Inout_opt_ LPDWORD pcbData,
530 _In_ BOOL,
531 _In_reads_bytes_opt_(dwDefaultDataSize) LPVOID,
532 _In_ DWORD dwDefaultDataSize);
533
534 #define SHRegGetUSValue WINELIB_NAME_AW(SHRegGetUSValue)
535
536 LONG
537 WINAPI
538 SHRegSetUSValueA(
539 _In_ LPCSTR,
540 _In_ LPCSTR,
541 _In_ DWORD,
542 _In_reads_bytes_opt_(cbData) LPVOID,
543 _In_opt_ DWORD cbData,
544 _In_opt_ DWORD);
545
546 LONG
547 WINAPI
548 SHRegSetUSValueW(
549 _In_ LPCWSTR,
550 _In_ LPCWSTR,
551 _In_ DWORD,
552 _In_reads_bytes_opt_(cbData) LPVOID,
553 _In_opt_ DWORD cbData,
554 _In_opt_ DWORD);
555
556 #define SHRegSetUSValue WINELIB_NAME_AW(SHRegSetUSValue)
557
558 BOOL
559 WINAPI
560 SHRegGetBoolUSValueA(
561 _In_ LPCSTR,
562 _In_opt_ LPCSTR,
563 _In_ BOOL,
564 _In_ BOOL);
565
566 BOOL
567 WINAPI
568 SHRegGetBoolUSValueW(
569 _In_ LPCWSTR,
570 _In_opt_ LPCWSTR,
571 _In_ BOOL,
572 _In_ BOOL);
573
574 #define SHRegGetBoolUSValue WINELIB_NAME_AW(SHRegGetBoolUSValue)
575
576 int WINAPI SHRegGetIntW(_In_ HKEY, _In_opt_ LPCWSTR, _In_ int);
577
578 /* IQueryAssociation and helpers */
579 enum
580 {
581 ASSOCF_INIT_NOREMAPCLSID = 0x001, /* Don't map clsid->progid */
582 ASSOCF_INIT_BYEXENAME = 0x002, /* .exe name given */
583 ASSOCF_OPEN_BYEXENAME = 0x002, /* Synonym */
584 ASSOCF_INIT_DEFAULTTOSTAR = 0x004, /* Use * as base */
585 ASSOCF_INIT_DEFAULTTOFOLDER = 0x008, /* Use folder as base */
586 ASSOCF_NOUSERSETTINGS = 0x010, /* No HKCU reads */
587 ASSOCF_NOTRUNCATE = 0x020, /* Don't truncate return */
588 ASSOCF_VERIFY = 0x040, /* Verify data */
589 ASSOCF_REMAPRUNDLL = 0x080, /* Get rundll args */
590 ASSOCF_NOFIXUPS = 0x100, /* Don't fixup errors */
591 ASSOCF_IGNOREBASECLASS = 0x200, /* Don't read baseclass */
592 ASSOCF_INIT_IGNOREUNKNOWN = 0x400, /* Fail for unknown progid */
593 };
594
595 typedef DWORD ASSOCF;
596
597 typedef enum
598 {
599 ASSOCSTR_COMMAND = 1, /* Verb command */
600 ASSOCSTR_EXECUTABLE, /* .exe from command string */
601 ASSOCSTR_FRIENDLYDOCNAME, /* Friendly doc type name */
602 ASSOCSTR_FRIENDLYAPPNAME, /* Friendly .exe name */
603 ASSOCSTR_NOOPEN, /* noopen value */
604 ASSOCSTR_SHELLNEWVALUE, /* Use shellnew key */
605 ASSOCSTR_DDECOMMAND, /* DDE command template */
606 ASSOCSTR_DDEIFEXEC, /* DDE command for process create */
607 ASSOCSTR_DDEAPPLICATION, /* DDE app name */
608 ASSOCSTR_DDETOPIC, /* DDE topic */
609 ASSOCSTR_INFOTIP, /* Infotip */
610 ASSOCSTR_QUICKTIP, /* Quick infotip */
611 ASSOCSTR_TILEINFO, /* Properties for tileview */
612 ASSOCSTR_CONTENTTYPE, /* Mimetype */
613 ASSOCSTR_DEFAULTICON, /* Icon */
614 ASSOCSTR_SHELLEXTENSION, /* GUID for shell extension handler */
615 ASSOCSTR_MAX
616 } ASSOCSTR;
617
618 typedef enum
619 {
620 ASSOCKEY_SHELLEXECCLASS = 1, /* Key for ShellExec */
621 ASSOCKEY_APP, /* Application */
622 ASSOCKEY_CLASS, /* Progid or class */
623 ASSOCKEY_BASECLASS, /* Base class */
624 ASSOCKEY_MAX
625 } ASSOCKEY;
626
627 typedef enum
628 {
629 ASSOCDATA_MSIDESCRIPTOR = 1, /* Component descriptor */
630 ASSOCDATA_NOACTIVATEHANDLER, /* Don't activate */
631 ASSOCDATA_QUERYCLASSSTORE, /* Look in Class Store */
632 ASSOCDATA_HASPERUSERASSOC, /* Use user association */
633 ASSOCDATA_EDITFLAGS, /* Edit flags */
634 ASSOCDATA_VALUE, /* pszExtra is value */
635 ASSOCDATA_MAX
636 } ASSOCDATA;
637
638 typedef enum
639 {
640 ASSOCENUM_NONE
641 } ASSOCENUM;
642
643 typedef struct IQueryAssociations *LPQUERYASSOCIATIONS;
644
645 #define INTERFACE IQueryAssociations
646 DECLARE_INTERFACE_(IQueryAssociations,IUnknown)
647 {
648 /*** IUnknown methods ***/
649 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
650 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
651 STDMETHOD_(ULONG,Release)(THIS) PURE;
652 /*** IQueryAssociations methods ***/
653 STDMETHOD(Init)(THIS_ _In_ ASSOCF flags, _In_opt_ LPCWSTR pszAssoc, _In_opt_ HKEY hkProgid, _In_opt_ HWND hwnd) PURE;
654 STDMETHOD(GetString)(THIS_ _In_ ASSOCF flags, _In_ ASSOCSTR str, _In_opt_ LPCWSTR pszExtra, _Out_writes_opt_(*pcchOut) LPWSTR pszOut, _Inout_ DWORD *pcchOut) PURE;
655 STDMETHOD(GetKey)(THIS_ _In_ ASSOCF flags, _In_ ASSOCKEY key, _In_opt_ LPCWSTR pszExtra, _Out_ HKEY *phkeyOut) PURE;
656 STDMETHOD(GetData)(THIS_ _In_ ASSOCF flags, _In_ ASSOCDATA data, _In_opt_ LPCWSTR pszExtra, _Out_writes_bytes_opt_(*pcbOut) LPVOID pvOut, _Inout_opt_ DWORD *pcbOut) PURE;
657 STDMETHOD(GetEnum)(THIS_ _In_ ASSOCF flags, _In_ ASSOCENUM assocenum, _In_opt_ LPCWSTR pszExtra, _In_ REFIID riid, _Outptr_ LPVOID *ppvOut) PURE;
658 };
659 #undef INTERFACE
660
661 #if !defined(__cplusplus) || defined(CINTERFACE)
662 #define IQueryAssociations_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
663 #define IQueryAssociations_AddRef(p) (p)->lpVtbl->AddRef(p)
664 #define IQueryAssociations_Release(p) (p)->lpVtbl->Release(p)
665 #define IQueryAssociations_Init(p,a,b,c,d) (p)->lpVtbl->Init(p,a,b,c,d)
666 #define IQueryAssociations_GetString(p,a,b,c,d,e) (p)->lpVtbl->GetString(p,a,b,c,d,e)
667 #define IQueryAssociations_GetKey(p,a,b,c,d) (p)->lpVtbl->GetKey(p,a,b,c,d)
668 #define IQueryAssociations_GetData(p,a,b,c,d,e) (p)->lpVtbl->GetData(p,a,b,c,d,e)
669 #define IQueryAssociations_GetEnum(p,a,b,c,d,e) (p)->lpVtbl->GetEnum(p,a,b,c,d,e)
670 #endif
671
672 HRESULT WINAPI AssocCreate(_In_ CLSID, _In_ REFIID, _Outptr_ LPVOID*);
673
674 HRESULT
675 WINAPI
676 AssocQueryStringA(
677 _In_ ASSOCF,
678 _In_ ASSOCSTR,
679 _In_ LPCSTR,
680 _In_opt_ LPCSTR,
681 _Out_writes_opt_(*pcchOut) LPSTR,
682 _Inout_ LPDWORD pcchOut);
683
684 HRESULT
685 WINAPI
686 AssocQueryStringW(
687 _In_ ASSOCF,
688 _In_ ASSOCSTR,
689 _In_ LPCWSTR,
690 _In_opt_ LPCWSTR,
691 _Out_writes_opt_(*pcchOut) LPWSTR,
692 _Inout_ LPDWORD pcchOut);
693
694 #define AssocQueryString WINELIB_NAME_AW(AssocQueryString)
695
696 HRESULT
697 WINAPI
698 AssocQueryStringByKeyA(
699 _In_ ASSOCF,
700 _In_ ASSOCSTR,
701 _In_ HKEY,
702 _In_opt_ LPCSTR,
703 _Out_writes_opt_(*pcchOut) LPSTR,
704 _Inout_ LPDWORD pcchOut);
705
706 HRESULT
707 WINAPI
708 AssocQueryStringByKeyW(
709 _In_ ASSOCF,
710 _In_ ASSOCSTR,
711 _In_ HKEY,
712 _In_opt_ LPCWSTR,
713 _Out_writes_opt_(*pcchOut) LPWSTR,
714 _Inout_ LPDWORD pcchOut);
715
716 #define AssocQueryStringByKey WINELIB_NAME_AW(AssocQueryStringByKey)
717
718 HRESULT
719 WINAPI
720 AssocQueryKeyA(
721 _In_ ASSOCF,
722 _In_ ASSOCKEY,
723 _In_ LPCSTR,
724 _In_opt_ LPCSTR,
725 _Out_ PHKEY);
726
727 HRESULT
728 WINAPI
729 AssocQueryKeyW(
730 _In_ ASSOCF,
731 _In_ ASSOCKEY,
732 _In_ LPCWSTR,
733 _In_opt_ LPCWSTR,
734 _Out_ PHKEY);
735
736 #define AssocQueryKey WINELIB_NAME_AW(AssocQueryKey)
737
738 BOOL WINAPI AssocIsDangerous(_In_ LPCWSTR);
739
740 #endif /* NO_SHLWAPI_REG */
741
742 void WINAPI IUnknown_Set(_Inout_ IUnknown **ppunk, _In_opt_ IUnknown *punk);
743 void WINAPI IUnknown_AtomicRelease(_Inout_opt_ IUnknown **punk);
744 HRESULT WINAPI IUnknown_GetWindow(_In_ IUnknown *punk, _Out_ HWND *phwnd);
745
746 HRESULT
747 WINAPI
748 IUnknown_SetSite(
749 _In_ IUnknown *punk,
750 _In_opt_ IUnknown *punkSite);
751
752 HRESULT
753 WINAPI
754 IUnknown_GetSite(
755 _In_ IUnknown *punk,
756 _In_ REFIID riid,
757 _Outptr_ void **ppv);
758
759 HRESULT
760 WINAPI
761 IUnknown_QueryService(
762 _In_opt_ IUnknown *punk,
763 _In_ REFGUID guidService,
764 _In_ REFIID riid,
765 _Outptr_ void **ppvOut);
766
767 /* Path functions */
768 #ifndef NO_SHLWAPI_PATH
769
770 /* GetPathCharType return flags */
771 #define GCT_INVALID 0x0
772 #define GCT_LFNCHAR 0x1
773 #define GCT_SHORTCHAR 0x2
774 #define GCT_WILD 0x4
775 #define GCT_SEPARATOR 0x8
776
777 LPSTR WINAPI PathAddBackslashA(_Inout_updates_(MAX_PATH) LPSTR);
778 LPWSTR WINAPI PathAddBackslashW(_Inout_updates_(MAX_PATH) LPWSTR);
779 #define PathAddBackslash WINELIB_NAME_AW(PathAddBackslash)
780
781 BOOL
782 WINAPI
783 PathAddExtensionA(
784 _Inout_updates_(MAX_PATH) LPSTR,
785 _In_opt_ LPCSTR);
786
787 BOOL
788 WINAPI
789 PathAddExtensionW(
790 _Inout_updates_(MAX_PATH) LPWSTR,
791 _In_opt_ LPCWSTR);
792
793 #define PathAddExtension WINELIB_NAME_AW(PathAddExtension)
794
795 BOOL WINAPI PathAppendA(_Inout_updates_(MAX_PATH) LPSTR, _In_ LPCSTR);
796 BOOL WINAPI PathAppendW(_Inout_updates_(MAX_PATH) LPWSTR, _In_ LPCWSTR);
797 #define PathAppend WINELIB_NAME_AW(PathAppend)
798
799 LPSTR WINAPI PathBuildRootA(_Out_writes_(4) LPSTR, int);
800 LPWSTR WINAPI PathBuildRootW(_Out_writes_(4) LPWSTR, int);
801 #define PathBuildRoot WINELIB_NAME_AW(PathBuiltRoot)
802
803 BOOL WINAPI PathCanonicalizeA(_Out_writes_(MAX_PATH) LPSTR, _In_ LPCSTR);
804 BOOL WINAPI PathCanonicalizeW(_Out_writes_(MAX_PATH) LPWSTR, _In_ LPCWSTR);
805 #define PathCanonicalize WINELIB_NAME_AW(PathCanonicalize)
806
807 LPSTR
808 WINAPI
809 PathCombineA(
810 _Out_writes_(MAX_PATH) LPSTR,
811 _In_opt_ LPCSTR,
812 _In_opt_ LPCSTR);
813
814 LPWSTR
815 WINAPI
816 PathCombineW(
817 _Out_writes_(MAX_PATH) LPWSTR,
818 _In_opt_ LPCWSTR,
819 _In_opt_ LPCWSTR);
820
821 #define PathCombine WINELIB_NAME_AW(PathCombine)
822
823 BOOL
824 WINAPI
825 PathCompactPathA(
826 _In_opt_ HDC,
827 _Inout_updates_(MAX_PATH) LPSTR,
828 _In_ UINT);
829
830 BOOL
831 WINAPI
832 PathCompactPathW(
833 _In_opt_ HDC,
834 _Inout_updates_(MAX_PATH) LPWSTR,
835 _In_ UINT);
836
837 #define PathCompactPath WINELIB_NAME_AW(PathCompactPath)
838
839 BOOL
840 WINAPI
841 PathCompactPathExA(
842 _Out_writes_(cchMax) LPSTR,
843 _In_ LPCSTR,
844 _In_ UINT cchMax,
845 _In_ DWORD);
846
847 BOOL
848 WINAPI
849 PathCompactPathExW(
850 _Out_writes_(cchMax) LPWSTR,
851 _In_ LPCWSTR,
852 _In_ UINT cchMax,
853 _In_ DWORD);
854
855 #define PathCompactPathEx WINELIB_NAME_AW(PathCompactPathEx)
856
857 int
858 WINAPI
859 PathCommonPrefixA(
860 _In_ LPCSTR,
861 _In_ LPCSTR,
862 _Out_writes_opt_(MAX_PATH) LPSTR);
863
864 int
865 WINAPI
866 PathCommonPrefixW(
867 _In_ LPCWSTR,
868 _In_ LPCWSTR,
869 _Out_writes_opt_(MAX_PATH) LPWSTR);
870
871 #define PathCommonPrefix WINELIB_NAME_AW(PathCommonPrefix)
872
873 HRESULT
874 WINAPI
875 PathCreateFromUrlA(
876 _In_ LPCSTR,
877 _Out_writes_to_(*pcchPath, *pcchPath) LPSTR,
878 _Inout_ LPDWORD pcchPath,
879 DWORD);
880
881 HRESULT
882 WINAPI
883 PathCreateFromUrlW(
884 _In_ LPCWSTR,
885 _Out_writes_to_(*pcchPath, *pcchPath) LPWSTR,
886 _Inout_ LPDWORD pcchPath,
887 DWORD);
888
889 #define PathCreateFromUrl WINELIB_NAME_AW(PathCreateFromUrl)
890
891 HRESULT WINAPI PathCreateFromUrlAlloc(_In_ LPCWSTR, _Outptr_ LPWSTR*, DWORD);
892
893 BOOL WINAPI PathFileExistsA(_In_ LPCSTR);
894 BOOL WINAPI PathFileExistsW(_In_ LPCWSTR);
895 #define PathFileExists WINELIB_NAME_AW(PathFileExists)
896
897 BOOL WINAPI PathFileExistsAndAttributesA(LPCSTR,DWORD*);
898 BOOL WINAPI PathFileExistsAndAttributesW(LPCWSTR,DWORD*);
899 #define PathFileExistsAndAttributes WINELIB_NAME_AW(PathFileExistsAndAttributes)
900
901 LPSTR WINAPI PathFindExtensionA(_In_ LPCSTR);
902 LPWSTR WINAPI PathFindExtensionW(_In_ LPCWSTR);
903 #define PathFindExtension WINELIB_NAME_AW(PathFindExtension)
904
905 LPSTR WINAPI PathFindFileNameA(_In_ LPCSTR);
906 LPWSTR WINAPI PathFindFileNameW(_In_ LPCWSTR);
907 #define PathFindFileName WINELIB_NAME_AW(PathFindFileName)
908
909 LPSTR WINAPI PathFindNextComponentA(_In_ LPCSTR);
910 LPWSTR WINAPI PathFindNextComponentW(_In_ LPCWSTR);
911 #define PathFindNextComponent WINELIB_NAME_AW(PathFindNextComponent)
912
913 BOOL WINAPI PathFindOnPathA(_Inout_updates_(MAX_PATH) LPSTR, _In_opt_ LPCSTR*);
914 BOOL WINAPI PathFindOnPathW(_Inout_updates_(MAX_PATH) LPWSTR, _In_opt_ LPCWSTR*);
915 #define PathFindOnPath WINELIB_NAME_AW(PathFindOnPath)
916
917 LPSTR WINAPI PathGetArgsA(_In_ LPCSTR);
918 LPWSTR WINAPI PathGetArgsW(_In_ LPCWSTR);
919 #define PathGetArgs WINELIB_NAME_AW(PathGetArgs)
920
921 UINT WINAPI PathGetCharTypeA(_In_ UCHAR);
922 UINT WINAPI PathGetCharTypeW(_In_ WCHAR);
923 #define PathGetCharType WINELIB_NAME_AW(PathGetCharType)
924
925 int WINAPI PathGetDriveNumberA(_In_ LPCSTR);
926 int WINAPI PathGetDriveNumberW(_In_ LPCWSTR);
927 #define PathGetDriveNumber WINELIB_NAME_AW(PathGetDriveNumber)
928
929 BOOL WINAPI PathIsDirectoryA(_In_ LPCSTR);
930 BOOL WINAPI PathIsDirectoryW(_In_ LPCWSTR);
931 #define PathIsDirectory WINELIB_NAME_AW(PathIsDirectory)
932
933 BOOL WINAPI PathIsDirectoryEmptyA(_In_ LPCSTR);
934 BOOL WINAPI PathIsDirectoryEmptyW(_In_ LPCWSTR);
935 #define PathIsDirectoryEmpty WINELIB_NAME_AW(PathIsDirectoryEmpty)
936
937 BOOL WINAPI PathIsFileSpecA(_In_ LPCSTR);
938 BOOL WINAPI PathIsFileSpecW(_In_ LPCWSTR);
939 #define PathIsFileSpec WINELIB_NAME_AW(PathIsFileSpec);
940
941 BOOL WINAPI PathIsPrefixA(_In_ LPCSTR, _In_ LPCSTR);
942 BOOL WINAPI PathIsPrefixW(_In_ LPCWSTR, _In_ LPCWSTR);
943 #define PathIsPrefix WINELIB_NAME_AW(PathIsPrefix)
944
945 BOOL WINAPI PathIsRelativeA(_In_ LPCSTR);
946 BOOL WINAPI PathIsRelativeW(_In_ LPCWSTR);
947 #define PathIsRelative WINELIB_NAME_AW(PathIsRelative)
948
949 BOOL WINAPI PathIsRootA(_In_ LPCSTR);
950 BOOL WINAPI PathIsRootW(_In_ LPCWSTR);
951 #define PathIsRoot WINELIB_NAME_AW(PathIsRoot)
952
953 BOOL WINAPI PathIsSameRootA(_In_ LPCSTR, _In_ LPCSTR);
954 BOOL WINAPI PathIsSameRootW(_In_ LPCWSTR, _In_ LPCWSTR);
955 #define PathIsSameRoot WINELIB_NAME_AW(PathIsSameRoot)
956
957 BOOL WINAPI PathIsUNCA(_In_ LPCSTR);
958 BOOL WINAPI PathIsUNCW(_In_ LPCWSTR);
959 #define PathIsUNC WINELIB_NAME_AW(PathIsUNC)
960
961 BOOL WINAPI PathIsUNCServerA(_In_ LPCSTR);
962 BOOL WINAPI PathIsUNCServerW(_In_ LPCWSTR);
963 #define PathIsUNCServer WINELIB_NAME_AW(PathIsUNCServer)
964
965 BOOL WINAPI PathIsUNCServerShareA(_In_ LPCSTR);
966 BOOL WINAPI PathIsUNCServerShareW(_In_ LPCWSTR);
967 #define PathIsUNCServerShare WINELIB_NAME_AW(PathIsUNCServerShare)
968
969 BOOL WINAPI PathIsContentTypeA(_In_ LPCSTR, _In_ LPCSTR);
970 BOOL WINAPI PathIsContentTypeW(_In_ LPCWSTR, _In_ LPCWSTR);
971 #define PathIsContentType WINELIB_NAME_AW(PathIsContentType)
972
973 BOOL WINAPI PathIsURLA(_In_ LPCSTR);
974 BOOL WINAPI PathIsURLW(_In_ LPCWSTR);
975 #define PathIsURL WINELIB_NAME_AW(PathIsURL)
976
977 BOOL WINAPI PathMakePrettyA(_Inout_ LPSTR);
978 BOOL WINAPI PathMakePrettyW(_Inout_ LPWSTR);
979 #define PathMakePretty WINELIB_NAME_AW(PathMakePretty)
980
981 BOOL WINAPI PathMatchSpecA(_In_ LPCSTR, _In_ LPCSTR);
982 BOOL WINAPI PathMatchSpecW(_In_ LPCWSTR, _In_ LPCWSTR);
983 #define PathMatchSpec WINELIB_NAME_AW(PathMatchSpec)
984
985 int WINAPI PathParseIconLocationA(_Inout_ LPSTR);
986 int WINAPI PathParseIconLocationW(_Inout_ LPWSTR);
987 #define PathParseIconLocation WINELIB_NAME_AW(PathParseIconLocation)
988
989 VOID WINAPI PathQuoteSpacesA(_Inout_updates_(MAX_PATH) LPSTR);
990 VOID WINAPI PathQuoteSpacesW(_Inout_updates_(MAX_PATH) LPWSTR);
991 #define PathQuoteSpaces WINELIB_NAME_AW(PathQuoteSpaces)
992
993 BOOL
994 WINAPI
995 PathRelativePathToA(
996 _Out_writes_(MAX_PATH) LPSTR,
997 _In_ LPCSTR,
998 _In_ DWORD,
999 _In_ LPCSTR,
1000 _In_ DWORD);
1001
1002 BOOL
1003 WINAPI
1004 PathRelativePathToW(
1005 _Out_writes_(MAX_PATH) LPWSTR,
1006 _In_ LPCWSTR,
1007 _In_ DWORD,
1008 _In_ LPCWSTR,
1009 _In_ DWORD);
1010
1011 #define PathRelativePathTo WINELIB_NAME_AW(PathRelativePathTo)
1012
1013 VOID WINAPI PathRemoveArgsA(_Inout_ LPSTR);
1014 VOID WINAPI PathRemoveArgsW(_Inout_ LPWSTR);
1015 #define PathRemoveArgs WINELIB_NAME_AW(PathRemoveArgs)
1016
1017 LPSTR WINAPI PathRemoveBackslashA(_Inout_ LPSTR);
1018 LPWSTR WINAPI PathRemoveBackslashW(_Inout_ LPWSTR);
1019 #define PathRemoveBackslash WINELIB_NAME_AW(PathRemoveBackslash)
1020
1021 VOID WINAPI PathRemoveBlanksA(_Inout_ LPSTR);
1022 VOID WINAPI PathRemoveBlanksW(_Inout_ LPWSTR);
1023 #define PathRemoveBlanks WINELIB_NAME_AW(PathRemoveBlanks)
1024
1025 VOID WINAPI PathRemoveExtensionA(_Inout_ LPSTR);
1026 VOID WINAPI PathRemoveExtensionW(_Inout_ LPWSTR);
1027 #define PathRemoveExtension WINELIB_NAME_AW(PathRemoveExtension)
1028
1029 BOOL WINAPI PathRemoveFileSpecA(_Inout_ LPSTR);
1030 BOOL WINAPI PathRemoveFileSpecW(_Inout_ LPWSTR);
1031 #define PathRemoveFileSpec WINELIB_NAME_AW(PathRemoveFileSpec)
1032
1033 BOOL
1034 WINAPI
1035 PathRenameExtensionA(
1036 _Inout_updates_(MAX_PATH) LPSTR,
1037 _In_ LPCSTR);
1038
1039 BOOL
1040 WINAPI
1041 PathRenameExtensionW(
1042 _Inout_updates_(MAX_PATH) LPWSTR,
1043 _In_ LPCWSTR);
1044
1045 #define PathRenameExtension WINELIB_NAME_AW(PathRenameExtension)
1046
1047 BOOL
1048 WINAPI
1049 PathSearchAndQualifyA(
1050 _In_ LPCSTR,
1051 _Out_writes_(cchBuf) LPSTR,
1052 _In_ UINT cchBuf);
1053
1054 BOOL
1055 WINAPI
1056 PathSearchAndQualifyW(
1057 _In_ LPCWSTR,
1058 _Out_writes_(cchBuf) LPWSTR,
1059 _In_ UINT cchBuf);
1060
1061 #define PathSearchAndQualify WINELIB_NAME_AW(PathSearchAndQualify)
1062
1063 VOID WINAPI PathSetDlgItemPathA(_In_ HWND, int, LPCSTR);
1064 VOID WINAPI PathSetDlgItemPathW(_In_ HWND, int, LPCWSTR);
1065 #define PathSetDlgItemPath WINELIB_NAME_AW(PathSetDlgItemPath)
1066
1067 LPSTR WINAPI PathSkipRootA(_In_ LPCSTR);
1068 LPWSTR WINAPI PathSkipRootW(_In_ LPCWSTR);
1069 #define PathSkipRoot WINELIB_NAME_AW(PathSkipRoot)
1070
1071 VOID WINAPI PathStripPathA(_Inout_ LPSTR);
1072 VOID WINAPI PathStripPathW(_Inout_ LPWSTR);
1073 #define PathStripPath WINELIB_NAME_AW(PathStripPath)
1074
1075 BOOL WINAPI PathStripToRootA(_Inout_ LPSTR);
1076 BOOL WINAPI PathStripToRootW(_Inout_ LPWSTR);
1077 #define PathStripToRoot WINELIB_NAME_AW(PathStripToRoot)
1078
1079 VOID WINAPI PathUnquoteSpacesA(_Inout_ LPSTR);
1080 VOID WINAPI PathUnquoteSpacesW(_Inout_ LPWSTR);
1081 #define PathUnquoteSpaces WINELIB_NAME_AW(PathUnquoteSpaces)
1082
1083 BOOL WINAPI PathMakeSystemFolderA(_In_ LPCSTR);
1084 BOOL WINAPI PathMakeSystemFolderW(_In_ LPCWSTR);
1085 #define PathMakeSystemFolder WINELIB_NAME_AW(PathMakeSystemFolder)
1086
1087 BOOL WINAPI PathUnmakeSystemFolderA(_In_ LPCSTR);
1088 BOOL WINAPI PathUnmakeSystemFolderW(_In_ LPCWSTR);
1089 #define PathUnmakeSystemFolder WINELIB_NAME_AW(PathUnmakeSystemFolder)
1090
1091 BOOL WINAPI PathIsSystemFolderA(_In_opt_ LPCSTR, _In_ DWORD);
1092 BOOL WINAPI PathIsSystemFolderW(_In_opt_ LPCWSTR, _In_ DWORD);
1093 #define PathIsSystemFolder WINELIB_NAME_AW(PathIsSystemFolder)
1094
1095 BOOL WINAPI PathIsNetworkPathA(_In_ LPCSTR);
1096 BOOL WINAPI PathIsNetworkPathW(_In_ LPCWSTR);
1097 #define PathIsNetworkPath WINELIB_NAME_AW(PathIsNetworkPath)
1098
1099 BOOL WINAPI PathIsLFNFileSpecA(_In_ LPCSTR);
1100 BOOL WINAPI PathIsLFNFileSpecW(_In_ LPCWSTR);
1101 #define PathIsLFNFileSpec WINELIB_NAME_AW(PathIsLFNFileSpec)
1102
1103 LPCSTR
1104 WINAPI
1105 PathFindSuffixArrayA(
1106 _In_ LPCSTR,
1107 _In_reads_(iArraySize) LPCSTR *,
1108 int iArraySize);
1109
1110 LPCWSTR
1111 WINAPI
1112 PathFindSuffixArrayW(
1113 _In_ LPCWSTR,
1114 _In_reads_(iArraySize) LPCWSTR *,
1115 int iArraySize);
1116
1117 #define PathFindSuffixArray WINELIB_NAME_AW(PathFindSuffixArray)
1118
1119 VOID WINAPI PathUndecorateA(_Inout_ LPSTR);
1120 VOID WINAPI PathUndecorateW(_Inout_ LPWSTR);
1121 #define PathUndecorate WINELIB_NAME_AW(PathUndecorate)
1122
1123 BOOL
1124 WINAPI
1125 PathUnExpandEnvStringsA(
1126 _In_ LPCSTR,
1127 _Out_writes_(cchBuf) LPSTR,
1128 _In_ UINT cchBuf);
1129
1130 BOOL
1131 WINAPI
1132 PathUnExpandEnvStringsW(
1133 _In_ LPCWSTR,
1134 _Out_writes_(cchBuf) LPWSTR,
1135 _In_ UINT cchBuf);
1136
1137 #define PathUnExpandEnvStrings WINELIB_NAME_AW(PathUnExpandEnvStrings)
1138
1139 /* Url functions */
1140 typedef enum {
1141 URL_SCHEME_INVALID = -1,
1142 URL_SCHEME_UNKNOWN = 0,
1143 URL_SCHEME_FTP,
1144 URL_SCHEME_HTTP,
1145 URL_SCHEME_GOPHER,
1146 URL_SCHEME_MAILTO,
1147 URL_SCHEME_NEWS,
1148 URL_SCHEME_NNTP,
1149 URL_SCHEME_TELNET,
1150 URL_SCHEME_WAIS,
1151 URL_SCHEME_FILE,
1152 URL_SCHEME_MK,
1153 URL_SCHEME_HTTPS,
1154 URL_SCHEME_SHELL,
1155 URL_SCHEME_SNEWS,
1156 URL_SCHEME_LOCAL,
1157 URL_SCHEME_JAVASCRIPT,
1158 URL_SCHEME_VBSCRIPT,
1159 URL_SCHEME_ABOUT,
1160 URL_SCHEME_RES,
1161 URL_SCHEME_MSSHELLROOTED,
1162 URL_SCHEME_MSSHELLIDLIST,
1163 URL_SCHEME_MSHELP,
1164 URL_SCHEME_MSSHELLDEVICE,
1165 URL_SCHEME_WILDCARD,
1166 URL_SCHEME_SEARCH_MS,
1167 URL_SCHEME_SEARCH,
1168 URL_SCHEME_KNOWNFOLDER,
1169 URL_SCHEME_MAXVALUE
1170 } URL_SCHEME;
1171
1172 /* These are used by UrlGetPart routine */
1173 typedef enum {
1174 URL_PART_NONE = 0,
1175 URL_PART_SCHEME = 1,
1176 URL_PART_HOSTNAME,
1177 URL_PART_USERNAME,
1178 URL_PART_PASSWORD,
1179 URL_PART_PORT,
1180 URL_PART_QUERY
1181 } URL_PART;
1182
1183 #define URL_PARTFLAG_KEEPSCHEME 0x00000001
1184
1185 /* These are used by the UrlIs... routines */
1186 typedef enum {
1187 URLIS_URL,
1188 URLIS_OPAQUE,
1189 URLIS_NOHISTORY,
1190 URLIS_FILEURL,
1191 URLIS_APPLIABLE,
1192 URLIS_DIRECTORY,
1193 URLIS_HASQUERY
1194 } URLIS;
1195
1196 /* This is used by the UrlApplyScheme... routines */
1197 #define URL_APPLY_FORCEAPPLY 0x00000008
1198 #define URL_APPLY_GUESSFILE 0x00000004
1199 #define URL_APPLY_GUESSSCHEME 0x00000002
1200 #define URL_APPLY_DEFAULT 0x00000001
1201
1202 /* The following are used by UrlEscape..., UrlUnEscape...,
1203 * UrlCanonicalize..., and UrlCombine... routines
1204 */
1205 #define URL_WININET_COMPATIBILITY 0x80000000
1206 #define URL_PLUGGABLE_PROTOCOL 0x40000000
1207 #define URL_ESCAPE_UNSAFE 0x20000000
1208 #define URL_UNESCAPE 0x10000000
1209
1210 #define URL_DONT_SIMPLIFY 0x08000000
1211 #define URL_NO_META URL_DONT_SIMPLIFY
1212 #define URL_ESCAPE_SPACES_ONLY 0x04000000
1213 #define URL_DONT_ESCAPE_EXTRA_INFO 0x02000000
1214 #define URL_DONT_UNESCAPE_EXTRA_INFO URL_DONT_ESCAPE_EXTRA_INFO
1215 #define URL_BROWSER_MODE URL_DONT_ESCAPE_EXTRA_INFO
1216
1217 #define URL_INTERNAL_PATH 0x00800000 /* Will escape #'s in paths */
1218 #define URL_UNESCAPE_HIGH_ANSI_ONLY 0x00400000
1219 #define URL_CONVERT_IF_DOSPATH 0x00200000
1220 #define URL_UNESCAPE_INPLACE 0x00100000
1221
1222 #define URL_FILE_USE_PATHURL 0x00010000
1223 #define URL_ESCAPE_AS_UTF8 0x00040000
1224
1225 #define URL_ESCAPE_SEGMENT_ONLY 0x00002000
1226 #define URL_ESCAPE_PERCENT 0x00001000
1227
1228 HRESULT
1229 WINAPI
1230 UrlApplySchemeA(
1231 _In_ LPCSTR,
1232 _Out_writes_(*pcchOut) LPSTR,
1233 _Inout_ LPDWORD pcchOut,
1234 DWORD);
1235
1236 HRESULT
1237 WINAPI
1238 UrlApplySchemeW(
1239 _In_ LPCWSTR,
1240 _Out_writes_(*pcchOut) LPWSTR,
1241 _Inout_ LPDWORD pcchOut,
1242 DWORD);
1243
1244 #define UrlApplyScheme WINELIB_NAME_AW(UrlApplyScheme)
1245
1246 HRESULT
1247 WINAPI
1248 UrlCanonicalizeA(
1249 _In_ LPCSTR,
1250 _Out_writes_to_(*pcchCanonicalized, *pcchCanonicalized) LPSTR,
1251 _Inout_ LPDWORD pcchCanonicalized,
1252 DWORD);
1253
1254 HRESULT
1255 WINAPI
1256 UrlCanonicalizeW(
1257 _In_ LPCWSTR,
1258 _Out_writes_to_(*pcchCanonicalized, *pcchCanonicalized) LPWSTR,
1259 _Inout_ LPDWORD pcchCanonicalized,
1260 DWORD);
1261
1262 #define UrlCanonicalize WINELIB_NAME_AW(UrlCanonicalize)
1263
1264 HRESULT
1265 WINAPI
1266 UrlCombineA(
1267 _In_ LPCSTR,
1268 _In_ LPCSTR,
1269 _Out_writes_to_opt_(*pcchCombined, *pcchCombined) LPSTR,
1270 _Inout_ LPDWORD pcchCombined,
1271 DWORD);
1272
1273 HRESULT
1274 WINAPI
1275 UrlCombineW(
1276 _In_ LPCWSTR,
1277 _In_ LPCWSTR,
1278 _Out_writes_to_opt_(*pcchCombined, *pcchCombined) LPWSTR,
1279 _Inout_ LPDWORD pcchCombined,
1280 DWORD);
1281
1282 #define UrlCombine WINELIB_NAME_AW(UrlCombine)
1283
1284 INT WINAPI UrlCompareA(_In_ LPCSTR, _In_ LPCSTR, BOOL);
1285 INT WINAPI UrlCompareW(_In_ LPCWSTR, _In_ LPCWSTR, BOOL);
1286 #define UrlCompare WINELIB_NAME_AW(UrlCompare)
1287
1288 HRESULT
1289 WINAPI
1290 UrlEscapeA(
1291 _In_ LPCSTR,
1292 _Out_writes_to_(*pcchEscaped, *pcchEscaped) LPSTR,
1293 _Inout_ LPDWORD pcchEscaped,
1294 DWORD);
1295
1296 HRESULT
1297 WINAPI
1298 UrlEscapeW(
1299 _In_ LPCWSTR,
1300 _Out_writes_to_(*pcchEscaped, *pcchEscaped) LPWSTR,
1301 _Inout_ LPDWORD pcchEscaped,
1302 DWORD);
1303
1304 #define UrlEscape WINELIB_NAME_AW(UrlEscape)
1305
1306 #define UrlEscapeSpacesA(x,y,z) UrlCanonicalizeA(x, y, z, \
1307 URL_DONT_ESCAPE_EXTRA_INFO|URL_ESCAPE_SPACES_ONLY)
1308 #define UrlEscapeSpacesW(x,y,z) UrlCanonicalizeW(x, y, z, \
1309 URL_DONT_ESCAPE_EXTRA_INFO|URL_ESCAPE_SPACES_ONLY)
1310 #define UrlEscapeSpaces WINELIB_NAME_AW(UrlEscapeSpaces)
1311
1312 LPCSTR WINAPI UrlGetLocationA(_In_ LPCSTR);
1313 LPCWSTR WINAPI UrlGetLocationW(_In_ LPCWSTR);
1314 #define UrlGetLocation WINELIB_NAME_AW(UrlGetLocation)
1315
1316 HRESULT
1317 WINAPI
1318 UrlGetPartA(
1319 _In_ LPCSTR,
1320 _Out_writes_(*pcchOut) LPSTR,
1321 _Inout_ LPDWORD pcchOut,
1322 DWORD,
1323 DWORD);
1324
1325 HRESULT
1326 WINAPI
1327 UrlGetPartW(
1328 _In_ LPCWSTR,
1329 _Out_writes_(*pcchOut) LPWSTR,
1330 _Inout_ LPDWORD pcchOut,
1331 DWORD,
1332 DWORD);
1333
1334 #define UrlGetPart WINELIB_NAME_AW(UrlGetPart)
1335
1336 HRESULT
1337 WINAPI
1338 HashData(
1339 _In_reads_bytes_(cbData) const unsigned char *,
1340 DWORD cbData,
1341 _Out_writes_bytes_(cbHash) unsigned char *lpDest,
1342 DWORD cbHash);
1343
1344 HRESULT
1345 WINAPI
1346 UrlHashA(
1347 _In_ LPCSTR,
1348 _Out_writes_bytes_(cbHash) unsigned char *,
1349 DWORD cbHash);
1350
1351 HRESULT
1352 WINAPI
1353 UrlHashW(
1354 _In_ LPCWSTR,
1355 _Out_writes_bytes_(cbHash) unsigned char *,
1356 DWORD cbHash);
1357
1358 #define UrlHash WINELIB_NAME_AW(UrlHash)
1359
1360 BOOL WINAPI UrlIsA(_In_ LPCSTR, URLIS);
1361 BOOL WINAPI UrlIsW(_In_ LPCWSTR, URLIS);
1362 #define UrlIs WINELIB_NAME_AW(UrlIs)
1363
1364 BOOL WINAPI UrlIsNoHistoryA(_In_ LPCSTR);
1365 BOOL WINAPI UrlIsNoHistoryW(_In_ LPCWSTR);
1366 #define UrlIsNoHistory WINELIB_NAME_AW(UrlIsNoHistory)
1367
1368 BOOL WINAPI UrlIsOpaqueA(_In_ LPCSTR);
1369 BOOL WINAPI UrlIsOpaqueW(_In_ LPCWSTR);
1370 #define UrlIsOpaque WINELIB_NAME_AW(UrlIsOpaque)
1371
1372 #define UrlIsFileUrlA(x) UrlIsA(x, URLIS_FILEURL)
1373 #define UrlIsFileUrlW(x) UrlIsW(x, URLIS_FILEURL)
1374 #define UrlIsFileUrl WINELIB_NAME_AW(UrlIsFileUrl)
1375
1376 HRESULT
1377 WINAPI
1378 UrlUnescapeA(
1379 _Inout_ LPSTR,
1380 _Out_writes_to_opt_(*pcchUnescaped, *pcchUnescaped) LPSTR,
1381 _Inout_opt_ LPDWORD pcchUnescaped,
1382 DWORD);
1383
1384 HRESULT
1385 WINAPI
1386 UrlUnescapeW(
1387 _Inout_ LPWSTR,
1388 _Out_writes_to_opt_(*pcchUnescaped, *pcchUnescaped) LPWSTR,
1389 _Inout_opt_ LPDWORD pcchUnescaped,
1390 DWORD);
1391
1392 #define UrlUnescape WINELIB_NAME_AW(UrlUnescape)
1393
1394 #define UrlUnescapeInPlaceA(x,y) UrlUnescapeA(x, NULL, NULL, \
1395 y | URL_UNESCAPE_INPLACE)
1396 #define UrlUnescapeInPlaceW(x,y) UrlUnescapeW(x, NULL, NULL, \
1397 y | URL_UNESCAPE_INPLACE)
1398 #define UrlUnescapeInPlace WINELIB_NAME_AW(UrlUnescapeInPlace)
1399
1400 HRESULT
1401 WINAPI
1402 UrlCreateFromPathA(
1403 _In_ LPCSTR,
1404 _Out_writes_to_(*pcchUrl, *pcchUrl) LPSTR,
1405 _Inout_ LPDWORD pcchUrl,
1406 DWORD);
1407
1408 HRESULT
1409 WINAPI
1410 UrlCreateFromPathW(
1411 _In_ LPCWSTR,
1412 _Out_writes_to_(*pcchUrl, *pcchUrl) LPWSTR,
1413 _Inout_ LPDWORD pcchUrl,
1414 DWORD);
1415
1416 #define UrlCreateFromPath WINELIB_NAME_AW(UrlCreateFromPath)
1417
1418 typedef struct tagPARSEDURLA {
1419 DWORD cbSize;
1420 LPCSTR pszProtocol;
1421 UINT cchProtocol;
1422 LPCSTR pszSuffix;
1423 UINT cchSuffix;
1424 UINT nScheme;
1425 } PARSEDURLA, *PPARSEDURLA;
1426
1427 typedef struct tagPARSEDURLW {
1428 DWORD cbSize;
1429 LPCWSTR pszProtocol;
1430 UINT cchProtocol;
1431 LPCWSTR pszSuffix;
1432 UINT cchSuffix;
1433 UINT nScheme;
1434 } PARSEDURLW, *PPARSEDURLW;
1435
1436 HRESULT WINAPI ParseURLA(_In_ LPCSTR pszUrl, _Inout_ PARSEDURLA *ppu);
1437 HRESULT WINAPI ParseURLW(_In_ LPCWSTR pszUrl, _Inout_ PARSEDURLW *ppu);
1438 #define ParseURL WINELIB_NAME_AW(ParseUrl)
1439
1440 #endif /* NO_SHLWAPI_PATH */
1441
1442
1443 /* String functions */
1444 #ifndef NO_SHLWAPI_STRFCNS
1445
1446 /* StrToIntEx flags */
1447 #define STIF_DEFAULT 0x0L
1448 #define STIF_SUPPORT_HEX 0x1L
1449
1450 BOOL WINAPI ChrCmpIA (WORD,WORD);
1451 BOOL WINAPI ChrCmpIW (WCHAR,WCHAR);
1452 #define ChrCmpI WINELIB_NAME_AW(ChrCmpI)
1453
1454 INT WINAPI StrCSpnA(_In_ LPCSTR, _In_ LPCSTR);
1455 INT WINAPI StrCSpnW(_In_ LPCWSTR, _In_ LPCWSTR);
1456 #define StrCSpn WINELIB_NAME_AW(StrCSpn)
1457
1458 INT WINAPI StrCSpnIA(_In_ LPCSTR, _In_ LPCSTR);
1459 INT WINAPI StrCSpnIW(_In_ LPCWSTR, _In_ LPCWSTR);
1460 #define StrCSpnI WINELIB_NAME_AW(StrCSpnI)
1461
1462 #define StrCatA lstrcatA
1463 LPWSTR WINAPI StrCatW(_Inout_ LPWSTR, _In_ LPCWSTR);
1464 #define StrCat WINELIB_NAME_AW(StrCat)
1465
1466 LPSTR
1467 WINAPI
1468 StrCatBuffA(
1469 _Inout_updates_(cchDestBuffSize) LPSTR,
1470 _In_ LPCSTR,
1471 INT cchDestBuffSize);
1472
1473 LPWSTR
1474 WINAPI
1475 StrCatBuffW(
1476 _Inout_updates_(cchDestBuffSize) LPWSTR,
1477 _In_ LPCWSTR,
1478 INT cchDestBuffSize);
1479
1480 #define StrCatBuff WINELIB_NAME_AW(StrCatBuff)
1481
1482 DWORD
1483 WINAPI
1484 StrCatChainW(
1485 _Out_writes_(cchDst) LPWSTR,
1486 DWORD cchDst,
1487 DWORD,
1488 _In_ LPCWSTR);
1489
1490 LPSTR WINAPI StrChrA(_In_ LPCSTR, WORD);
1491 LPWSTR WINAPI StrChrW(_In_ LPCWSTR, WCHAR);
1492 #define StrChr WINELIB_NAME_AW(StrChr)
1493
1494 LPSTR WINAPI StrChrIA(_In_ LPCSTR, WORD);
1495 LPWSTR WINAPI StrChrIW(_In_ LPCWSTR, WCHAR);
1496 #define StrChrI WINELIB_NAME_AW(StrChrI)
1497
1498 #define StrCmpA lstrcmpA
1499 int WINAPI StrCmpW(_In_ LPCWSTR, _In_ LPCWSTR);
1500 #define StrCmp WINELIB_NAME_AW(StrCmp)
1501
1502 #define StrCmpIA lstrcmpiA
1503 int WINAPI StrCmpIW(_In_ LPCWSTR, _In_ LPCWSTR);
1504 #define StrCmpI WINELIB_NAME_AW(StrCmpI)
1505
1506 #define StrCpyA lstrcpyA
1507 LPWSTR WINAPI StrCpyW(_Out_ LPWSTR, _In_ LPCWSTR);
1508 #define StrCpy WINELIB_NAME_AW(StrCpy)
1509
1510 #define StrCpyNA lstrcpynA
1511 LPWSTR WINAPI StrCpyNW(_Out_writes_(cchMax) LPWSTR, _In_ LPCWSTR, int cchMax);
1512 #define StrCpyN WINELIB_NAME_AW(StrCpyN)
1513 #define StrNCpy WINELIB_NAME_AW(StrCpyN)
1514
1515 INT WINAPI StrCmpLogicalW(_In_ LPCWSTR, _In_ LPCWSTR);
1516
1517 INT WINAPI StrCmpNA(_In_ LPCSTR, _In_ LPCSTR, INT);
1518 INT WINAPI StrCmpNW(_In_ LPCWSTR, _In_ LPCWSTR, INT);
1519 #define StrCmpN WINELIB_NAME_AW(StrCmpN)
1520 #define StrNCmp WINELIB_NAME_AW(StrCmpN)
1521
1522 INT WINAPI StrCmpNIA(_In_ LPCSTR, _In_ LPCSTR, INT);
1523 INT WINAPI StrCmpNIW(_In_ LPCWSTR, _In_ LPCWSTR, INT);
1524 #define StrCmpNI WINELIB_NAME_AW(StrCmpNI)
1525 #define StrNCmpI WINELIB_NAME_AW(StrCmpNI)
1526
1527 LPSTR WINAPI StrDupA(_In_ LPCSTR);
1528 LPWSTR WINAPI StrDupW(_In_ LPCWSTR);
1529 #define StrDup WINELIB_NAME_AW(StrDup)
1530
1531 HRESULT WINAPI SHStrDupA(_In_ LPCSTR, _Outptr_ WCHAR**);
1532 HRESULT WINAPI SHStrDupW(_In_ LPCWSTR, _Outptr_ WCHAR**);
1533 #define SHStrDup WINELIB_NAME_AW(SHStrDup)
1534
1535 LPSTR
1536 WINAPI
1537 StrFormatByteSizeA(
1538 DWORD,
1539 _Out_writes_(cchBuf) LPSTR,
1540 UINT cchBuf);
1541
1542 /* A/W Pairing is broken for this function */
1543
1544 LPSTR
1545 WINAPI
1546 StrFormatByteSize64A(
1547 LONGLONG,
1548 _Out_writes_(cchBuf) LPSTR,
1549 UINT cchBuf);
1550
1551 LPWSTR
1552 WINAPI
1553 StrFormatByteSizeW(
1554 LONGLONG,
1555 _Out_writes_(cchBuf) LPWSTR,
1556 UINT cchBuf);
1557
1558 #ifndef WINE_NO_UNICODE_MACROS
1559 #ifdef UNICODE
1560 #define StrFormatByteSize StrFormatByteSizeW
1561 #else
1562 #define StrFormatByteSize StrFormatByteSize64A
1563 #endif
1564 #endif
1565
1566 LPSTR
1567 WINAPI
1568 StrFormatKBSizeA(
1569 LONGLONG,
1570 _Out_writes_(cchBuf) LPSTR,
1571 UINT cchBuf);
1572
1573 LPWSTR
1574 WINAPI
1575 StrFormatKBSizeW(
1576 LONGLONG,
1577 _Out_writes_(cchBuf) LPWSTR,
1578 UINT cchBuf);
1579
1580 #define StrFormatKBSize WINELIB_NAME_AW(StrFormatKBSize)
1581
1582 int
1583 WINAPI
1584 StrFromTimeIntervalA(
1585 _Out_writes_(cchMax) LPSTR,
1586 UINT cchMax,
1587 DWORD,
1588 int);
1589
1590 int
1591 WINAPI
1592 StrFromTimeIntervalW(
1593 _Out_writes_(cchMax) LPWSTR,
1594 UINT cchMax,
1595 DWORD,
1596 int);
1597
1598 #define StrFromTimeInterval WINELIB_NAME_AW(StrFromTimeInterval)
1599
1600 BOOL WINAPI StrIsIntlEqualA(BOOL, _In_ LPCSTR, _In_ LPCSTR, int);
1601 BOOL WINAPI StrIsIntlEqualW(BOOL, _In_ LPCWSTR, _In_ LPCWSTR, int);
1602 #define StrIsIntlEqual WINELIB_NAME_AW(StrIsIntlEqual)
1603
1604 #define StrIntlEqNA(a,b,c) StrIsIntlEqualA(TRUE,a,b,c)
1605 #define StrIntlEqNW(a,b,c) StrIsIntlEqualW(TRUE,a,b,c)
1606
1607 #define StrIntlEqNIA(a,b,c) StrIsIntlEqualA(FALSE,a,b,c)
1608 #define StrIntlEqNIW(a,b,c) StrIsIntlEqualW(FALSE,a,b,c)
1609
1610 LPSTR WINAPI StrNCatA(_Inout_updates_(cchMax) LPSTR, LPCSTR, int cchMax);
1611 LPWSTR WINAPI StrNCatW(_Inout_updates_(cchMax) LPWSTR, LPCWSTR, int cchMax);
1612 #define StrNCat WINELIB_NAME_AW(StrNCat)
1613 #define StrCatN WINELIB_NAME_AW(StrNCat)
1614
1615 LPSTR WINAPI StrPBrkA(_In_ LPCSTR, _In_ LPCSTR);
1616 LPWSTR WINAPI StrPBrkW(_In_ LPCWSTR, _In_ LPCWSTR);
1617 #define StrPBrk WINELIB_NAME_AW(StrPBrk)
1618
1619 LPSTR WINAPI StrRChrA(_In_ LPCSTR, _In_opt_ LPCSTR, WORD);
1620 LPWSTR WINAPI StrRChrW(_In_ LPCWSTR, _In_opt_ LPCWSTR, WCHAR);
1621 #define StrRChr WINELIB_NAME_AW(StrRChr)
1622
1623 LPSTR WINAPI StrRChrIA(_In_ LPCSTR, _In_opt_ LPCSTR, WORD);
1624 LPWSTR WINAPI StrRChrIW(_In_ LPCWSTR, _In_opt_ LPCWSTR, WCHAR);
1625 #define StrRChrI WINELIB_NAME_AW(StrRChrI)
1626
1627 LPSTR WINAPI StrRStrIA(_In_ LPCSTR, _In_opt_ LPCSTR, _In_ LPCSTR);
1628 LPWSTR WINAPI StrRStrIW(_In_ LPCWSTR, _In_opt_ LPCWSTR, _In_ LPCWSTR);
1629 #define StrRStrI WINELIB_NAME_AW(StrRStrI)
1630
1631 int WINAPI StrSpnA(_In_ LPCSTR, _In_ LPCSTR);
1632 int WINAPI StrSpnW(_In_ LPCWSTR, _In_ LPCWSTR);
1633 #define StrSpn WINELIB_NAME_AW(StrSpn)
1634
1635 LPSTR WINAPI StrStrA(_In_ LPCSTR, _In_ LPCSTR);
1636 LPWSTR WINAPI StrStrW(_In_ LPCWSTR, _In_ LPCWSTR);
1637 #define StrStr WINELIB_NAME_AW(StrStr)
1638
1639 LPSTR WINAPI StrStrIA(_In_ LPCSTR, _In_ LPCSTR);
1640 LPWSTR WINAPI StrStrIW(_In_ LPCWSTR, _In_ LPCWSTR);
1641 #define StrStrI WINELIB_NAME_AW(StrStrI)
1642
1643 LPWSTR WINAPI StrStrNW(_In_ LPCWSTR, _In_ LPCWSTR, UINT);
1644 LPWSTR WINAPI StrStrNIW(_In_ LPCWSTR, _In_ LPCWSTR, UINT);
1645
1646 int WINAPI StrToIntA(_In_ LPCSTR);
1647 int WINAPI StrToIntW(_In_ LPCWSTR);
1648 #define StrToInt WINELIB_NAME_AW(StrToInt)
1649 #define StrToLong WINELIB_NAME_AW(StrToInt)
1650
1651 BOOL WINAPI StrToIntExA(_In_ LPCSTR, DWORD, _Out_ int*);
1652 BOOL WINAPI StrToIntExW(_In_ LPCWSTR, DWORD, _Out_ int*);
1653 #define StrToIntEx WINELIB_NAME_AW(StrToIntEx)
1654
1655 BOOL WINAPI StrToInt64ExA(_In_ LPCSTR, DWORD, _Out_ LONGLONG*);
1656 BOOL WINAPI StrToInt64ExW(_In_ LPCWSTR, DWORD, _Out_ LONGLONG*);
1657 #define StrToIntEx64 WINELIB_NAME_AW(StrToIntEx64)
1658
1659 BOOL WINAPI StrTrimA(_Inout_ LPSTR, _In_ LPCSTR);
1660 BOOL WINAPI StrTrimW(_Inout_ LPWSTR, _In_ LPCWSTR);
1661 #define StrTrim WINELIB_NAME_AW(StrTrim)
1662
1663 INT
1664 WINAPI
1665 wvnsprintfA(
1666 _Out_writes_(cchDest) LPSTR,
1667 _In_ INT cchDest,
1668 _In_ _Printf_format_string_ LPCSTR,
1669 _In_ __ms_va_list);
1670
1671 INT
1672 WINAPI
1673 wvnsprintfW(
1674 _Out_writes_(cchDest) LPWSTR,
1675 _In_ INT cchDest,
1676 _In_ _Printf_format_string_ LPCWSTR,
1677 _In_ __ms_va_list);
1678
1679 #define wvnsprintf WINELIB_NAME_AW(wvnsprintf)
1680
1681 INT
1682 WINAPIV
1683 wnsprintfA(
1684 _Out_writes_(cchDest) LPSTR,
1685 _In_ INT cchDest,
1686 _In_ _Printf_format_string_ LPCSTR,
1687 ...);
1688
1689 INT
1690 WINAPIV
1691 wnsprintfW(
1692 _Out_writes_(cchDest) LPWSTR,
1693 _In_ INT cchDest,
1694 _In_ _Printf_format_string_ LPCWSTR,
1695 ...);
1696
1697 #define wnsprintf WINELIB_NAME_AW(wnsprintf)
1698
1699 HRESULT
1700 WINAPI
1701 SHLoadIndirectString(
1702 _In_ LPCWSTR,
1703 _Out_writes_(cchOutBuf) LPWSTR,
1704 _In_ UINT cchOutBuf,
1705 _Reserved_ PVOID*);
1706
1707 BOOL
1708 WINAPI
1709 IntlStrEqWorkerA(
1710 BOOL,
1711 _In_reads_(nChar) LPCSTR,
1712 _In_reads_(nChar) LPCSTR,
1713 int nChar);
1714
1715 BOOL
1716 WINAPI
1717 IntlStrEqWorkerW(
1718 BOOL,
1719 _In_reads_(nChar) LPCWSTR,
1720 _In_reads_(nChar) LPCWSTR,
1721 int nChar);
1722
1723 #define IntlStrEqWorker WINELIB_NAME_AW(IntlStrEqWorker)
1724
1725 #define IntlStrEqNA(s1,s2,n) IntlStrEqWorkerA(TRUE,s1,s2,n)
1726 #define IntlStrEqNW(s1,s2,n) IntlStrEqWorkerW(TRUE,s1,s2,n)
1727 #define IntlStrEqN WINELIB_NAME_AW(IntlStrEqN)
1728
1729 #define IntlStrEqNIA(s1,s2,n) IntlStrEqWorkerA(FALSE,s1,s2,n)
1730 #define IntlStrEqNIW(s1,s2,n) IntlStrEqWorkerW(FALSE,s1,s2,n)
1731 #define IntlStrEqNI WINELIB_NAME_AW(IntlStrEqNI)
1732
1733 HRESULT
1734 WINAPI
1735 StrRetToStrA(
1736 _Inout_ STRRET*,
1737 _In_opt_ LPCITEMIDLIST,
1738 _Outptr_ LPSTR*);
1739
1740 HRESULT
1741 WINAPI
1742 StrRetToStrW(
1743 _Inout_ STRRET*,
1744 _In_opt_ LPCITEMIDLIST,
1745 _Outptr_ LPWSTR*);
1746
1747 #define StrRetToStr WINELIB_NAME_AW(StrRetToStr)
1748
1749 HRESULT
1750 WINAPI
1751 StrRetToBufA(
1752 _Inout_ STRRET*,
1753 _In_opt_ LPCITEMIDLIST,
1754 _Out_writes_(cchBuf) LPSTR,
1755 UINT cchBuf);
1756
1757 HRESULT
1758 WINAPI
1759 StrRetToBufW(
1760 _Inout_ STRRET*,
1761 _In_opt_ LPCITEMIDLIST,
1762 _Out_writes_(cchBuf) LPWSTR,
1763 UINT cchBuf);
1764
1765 #define StrRetToBuf WINELIB_NAME_AW(StrRetToBuf)
1766
1767 HRESULT
1768 WINAPI
1769 StrRetToBSTR(
1770 _Inout_ STRRET*,
1771 _In_opt_ LPCITEMIDLIST,
1772 _Outptr_ BSTR*);
1773
1774 BOOL WINAPI IsCharSpaceA(CHAR);
1775 BOOL WINAPI IsCharSpaceW(WCHAR);
1776 #define IsCharSpace WINELIB_NAME_AW(IsCharSpace)
1777
1778 #endif /* NO_SHLWAPI_STRFCNS */
1779
1780
1781 /* GDI functions */
1782 #ifndef NO_SHLWAPI_GDI
1783
1784 HPALETTE WINAPI SHCreateShellPalette(_In_opt_ HDC);
1785
1786 COLORREF WINAPI ColorHLSToRGB(WORD,WORD,WORD);
1787
1788 COLORREF WINAPI ColorAdjustLuma(COLORREF,int,BOOL);
1789
1790 VOID WINAPI ColorRGBToHLS(COLORREF, _Out_ LPWORD, _Out_ LPWORD, _Out_ LPWORD);
1791
1792 #endif /* NO_SHLWAPI_GDI */
1793
1794 /* Security functions */
1795 BOOL WINAPI IsInternetESCEnabled(void);
1796
1797 /* Stream functions */
1798 #ifndef NO_SHLWAPI_STREAM
1799
1800 struct IStream *
1801 WINAPI
1802 SHOpenRegStreamA(
1803 _In_ HKEY,
1804 _In_opt_ LPCSTR,
1805 _In_opt_ LPCSTR,
1806 _In_ DWORD);
1807
1808 struct IStream *
1809 WINAPI
1810 SHOpenRegStreamW(
1811 _In_ HKEY,
1812 _In_opt_ LPCWSTR,
1813 _In_opt_ LPCWSTR,
1814 _In_ DWORD);
1815
1816 #define SHOpenRegStream WINELIB_NAME_AW(SHOpenRegStream2) /* Uses version 2 */
1817
1818 struct IStream *
1819 WINAPI
1820 SHOpenRegStream2A(
1821 _In_ HKEY,
1822 _In_opt_ LPCSTR,
1823 _In_opt_ LPCSTR,
1824 _In_ DWORD);
1825
1826 struct IStream *
1827 WINAPI
1828 SHOpenRegStream2W(
1829 _In_ HKEY,
1830 _In_opt_ LPCWSTR,
1831 _In_opt_ LPCWSTR,
1832 _In_ DWORD);
1833
1834 #define SHOpenRegStream2 WINELIB_NAME_AW(SHOpenRegStream2)
1835
1836 HRESULT
1837 WINAPI
1838 SHCreateStreamOnFileA(
1839 _In_ LPCSTR,
1840 _In_ DWORD,
1841 _Outptr_ struct IStream**);
1842
1843 HRESULT
1844 WINAPI
1845 SHCreateStreamOnFileW(
1846 _In_ LPCWSTR,
1847 _In_ DWORD,
1848 _Outptr_ struct IStream**);
1849
1850 #define SHCreateStreamOnFile WINELIB_NAME_AW(SHCreateStreamOnFile)
1851
1852 HRESULT
1853 WINAPI
1854 SHCreateStreamOnFileEx(
1855 _In_ LPCWSTR,
1856 _In_ DWORD,
1857 _In_ DWORD,
1858 _In_ BOOL,
1859 _In_opt_ struct IStream*,
1860 _Outptr_ struct IStream**);
1861
1862 HRESULT WINAPI SHCreateStreamWrapper(LPBYTE,DWORD,DWORD,struct IStream**);
1863
1864 #endif /* NO_SHLWAPI_STREAM */
1865
1866 #ifndef NO_SHLWAPI_SHARED
1867
1868 // These functions are only included in this file starting with the Windows 7 platform SDK
1869
1870 HANDLE
1871 WINAPI
1872 SHAllocShared(
1873 _In_opt_ const void *pvData,
1874 _In_ DWORD dwSize,
1875 _In_ DWORD dwDestinationProcessId
1876 );
1877
1878 PVOID
1879 WINAPI
1880 SHLockShared(
1881 _In_ HANDLE hData,
1882 _In_ DWORD dwProcessId
1883 );
1884
1885 BOOL
1886 WINAPI
1887 SHUnlockShared(
1888 _In_ void *pvData
1889 );
1890
1891 BOOL
1892 WINAPI
1893 SHFreeShared(
1894 _In_ HANDLE hData,
1895 _In_ DWORD dwProcessId
1896 );
1897
1898 #endif /* NO_SHLWAPI_SHARED */
1899
1900 /* SHAutoComplete flags */
1901 #define SHACF_DEFAULT 0x00000000
1902 #define SHACF_FILESYSTEM 0x00000001
1903 #define SHACF_URLHISTORY 0x00000002
1904 #define SHACF_URLMRU 0x00000004
1905 #define SHACF_URLALL (SHACF_URLHISTORY|SHACF_URLMRU)
1906 #define SHACF_USETAB 0x00000008
1907 #define SHACF_FILESYS_ONLY 0x00000010
1908 #define SHACF_FILESYS_DIRS 0x00000020
1909 #define SHACF_AUTOSUGGEST_FORCE_ON 0x10000000
1910 #define SHACF_AUTOSUGGEST_FORCE_OFF 0x20000000
1911 #define SHACF_AUTOAPPEND_FORCE_ON 0x40000000
1912 #define SHACF_AUTOAPPEND_FORCE_OFF 0x80000000
1913
1914 HRESULT WINAPI SHAutoComplete(_In_ HWND, DWORD);
1915
1916 /* Threads */
1917 HRESULT WINAPI SHCreateThreadRef(_Inout_ LONG*, _Outptr_ IUnknown**);
1918 HRESULT WINAPI SHGetThreadRef(_Outptr_ IUnknown**);
1919 HRESULT WINAPI SHSetThreadRef(_In_opt_ IUnknown*);
1920 HRESULT WINAPI SHReleaseThreadRef(void);
1921
1922 /* SHCreateThread flags */
1923 #define CTF_INSIST 0x01 /* Always call */
1924 #define CTF_THREAD_REF 0x02 /* Hold thread ref */
1925 #define CTF_PROCESS_REF 0x04 /* Hold process ref */
1926 #define CTF_COINIT 0x08 /* Startup COM first */
1927 #define CTF_FREELIBANDEXIT 0x10 /* Hold DLL ref */
1928 #define CTF_REF_COUNTED 0x20 /* Thread is ref counted */
1929 #define CTF_WAIT_ALLOWCOM 0x40 /* Allow marshalling */
1930
1931 BOOL
1932 WINAPI
1933 SHCreateThread(
1934 _In_ LPTHREAD_START_ROUTINE,
1935 _In_opt_ void*,
1936 _In_ DWORD,
1937 _In_opt_ LPTHREAD_START_ROUTINE);
1938
1939 BOOL WINAPI SHSkipJunction(_In_opt_ struct IBindCtx*, _In_ const CLSID*);
1940
1941 /* Version Information */
1942
1943 typedef struct _DllVersionInfo {
1944 DWORD cbSize;
1945 DWORD dwMajorVersion;
1946 DWORD dwMinorVersion;
1947 DWORD dwBuildNumber;
1948 DWORD dwPlatformID;
1949 } DLLVERSIONINFO;
1950
1951 #define DLLVER_PLATFORM_WINDOWS 0x01 /* Win9x */
1952 #define DLLVER_PLATFORM_NT 0x02 /* WinNT */
1953
1954 typedef HRESULT (CALLBACK *DLLGETVERSIONPROC)(DLLVERSIONINFO *);
1955
1956 #ifdef __WINESRC__
1957 /* shouldn't be here, but is nice for type checking */
1958 HRESULT WINAPI DllGetVersion(DLLVERSIONINFO *) DECLSPEC_HIDDEN;
1959 #endif
1960
1961 typedef struct _DLLVERSIONINFO2 {
1962 DLLVERSIONINFO info1;
1963 DWORD dwFlags; /* Reserved */
1964 ULONGLONG DECLSPEC_ALIGN(8) ullVersion; /* 16 bits each for Major, Minor, Build, QFE */
1965 } DLLVERSIONINFO2;
1966
1967 #define DLLVER_MAJOR_MASK 0xFFFF000000000000
1968 #define DLLVER_MINOR_MASK 0x0000FFFF00000000
1969 #define DLLVER_BUILD_MASK 0x00000000FFFF0000
1970 #define DLLVER_QFE_MASK 0x000000000000FFFF
1971
1972 #define MAKEDLLVERULL(mjr, mnr, bld, qfe) (((ULONGLONG)(mjr)<< 48)| \
1973 ((ULONGLONG)(mnr)<< 32) | ((ULONGLONG)(bld)<< 16) | (ULONGLONG)(qfe))
1974
1975 HRESULT WINAPI DllInstall(BOOL, _In_opt_ LPCWSTR) DECLSPEC_HIDDEN;
1976
1977
1978 #if (_WIN32_IE >= 0x0600)
1979 #define SHGVSPB_PERUSER 0x00000001
1980 #define SHGVSPB_ALLUSERS 0x00000002
1981 #define SHGVSPB_PERFOLDER 0x00000004
1982 #define SHGVSPB_ALLFOLDERS 0x00000008
1983 #define SHGVSPB_INHERIT 0x00000010
1984 #define SHGVSPB_ROAM 0x00000020
1985 #define SHGVSPB_NOAUTODEFAULTS 0x80000000
1986
1987 #define SHGVSPB_FOLDER (SHGVSPB_PERUSER | SHGVSPB_PERFOLDER)
1988 #define SHGVSPB_FOLDERNODEFAULTS (SHGVSPB_PERUSER | SHGVSPB_PERFOLDER | SHGVSPB_NOAUTODEFAULTS)
1989 #define SHGVSPB_USERDEFAULTS (SHGVSPB_PERUSER | SHGVSPB_ALLFOLDERS)
1990 #define SHGVSPB_GLOBALDEAFAULTS (SHGVSPB_ALLUSERS | SHGVSPB_ALLFOLDERS)
1991
1992 HRESULT
1993 WINAPI
1994 SHGetViewStatePropertyBag(
1995 _In_opt_ LPCITEMIDLIST pidl,
1996 _In_opt_ LPWSTR bag_name,
1997 DWORD flags,
1998 _In_ REFIID riid,
1999 _Outptr_ void **ppv);
2000
2001 #endif /* (_WIN32_IE >= 0x0600) */
2002
2003
2004 /* IsOS definitions */
2005
2006 #define OS_WIN32SORGREATER 0x00
2007 #define OS_NT 0x01
2008 #define OS_WIN95ORGREATER 0x02
2009 #define OS_NT4ORGREATER 0x03
2010 #define OS_WIN2000ORGREATER_ALT 0x04
2011 #define OS_WIN98ORGREATER 0x05
2012 #define OS_WIN98_GOLD 0x06
2013 #define OS_WIN2000ORGREATER 0x07
2014 #define OS_WIN2000PRO 0x08
2015 #define OS_WIN2000SERVER 0x09
2016 #define OS_WIN2000ADVSERVER 0x0A
2017 #define OS_WIN2000DATACENTER 0x0B
2018 #define OS_WIN2000TERMINAL 0x0C
2019 #define OS_EMBEDDED 0x0D
2020 #define OS_TERMINALCLIENT 0x0E
2021 #define OS_TERMINALREMOTEADMIN 0x0F
2022 #define OS_WIN95_GOLD 0x10
2023 #define OS_MEORGREATER 0x11
2024 #define OS_XPORGREATER 0x12
2025 #define OS_HOME 0x13
2026 #define OS_PROFESSIONAL 0x14
2027 #define OS_DATACENTER 0x15
2028 #define OS_ADVSERVER 0x16
2029 #define OS_SERVER 0x17
2030 #define OS_TERMINALSERVER 0x18
2031 #define OS_PERSONALTERMINALSERVER 0x19
2032 #define OS_FASTUSERSWITCHING 0x1A
2033 #define OS_WELCOMELOGONUI 0x1B
2034 #define OS_DOMAINMEMBER 0x1C
2035 #define OS_ANYSERVER 0x1D
2036 #define OS_WOW6432 0x1E
2037 #define OS_WEBSERVER 0x1F
2038 #define OS_SMALLBUSINESSSERVER 0x20
2039 #define OS_TABLETPC 0x21
2040 #define OS_SERVERADMINUI 0x22
2041 #define OS_MEDIACENTER 0x23
2042 #define OS_APPLIANCE 0x24
2043
2044 BOOL WINAPI IsOS(DWORD);
2045
2046 /* SHSetTimerQueueTimer definitions */
2047 #define TPS_EXECUTEIO 0x00000001
2048 #define TPS_LONGEXECTIME 0x00000008
2049
2050 /* SHFormatDateTimeA/SHFormatDateTimeW flags */
2051 #define FDTF_SHORTTIME 0x00000001
2052 #define FDTF_SHORTDATE 0x00000002
2053 #define FDTF_DEFAULT (FDTF_SHORTDATE | FDTF_SHORTTIME)
2054 #define FDTF_LONGDATE 0x00000004
2055 #define FDTF_LONGTIME 0x00000008
2056 #define FDTF_RELATIVE 0x00000010
2057 #define FDTF_LTRDATE 0x00000100
2058 #define FDTF_RTLDATE 0x00000200
2059 #define FDTF_NOAUTOREADINGORDER 0x00000400
2060
2061
2062 typedef struct
2063 {
2064 const IID *piid;
2065 int dwOffset;
2066 } QITAB, *LPQITAB;
2067
2068 HRESULT
2069 WINAPI
2070 QISearch(
2071 _Inout_ void* base,
2072 _In_ const QITAB *pqit,
2073 _In_ REFIID riid,
2074 _Outptr_ void **ppv);
2075
2076 #define OFFSETOFCLASS(base, derived) \
2077 ((DWORD)(DWORD_PTR)(static_cast<base*>((derived*)8))-8)
2078
2079 #include <poppack.h>
2080
2081 #ifdef __cplusplus
2082 } /* extern "C" */
2083 #endif /* defined(__cplusplus) */
2084
2085 #endif /* __WINE_SHLWAPI_H */
A free Windows-compatible Operating System