2 * SHLWAPI.DLL functions
4 * Copyright (C) 2000 Juergen Schmied
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.
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.
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
21 #ifndef __WINE_SHLWAPI_H
22 #define __WINE_SHLWAPI_H
24 #include <specstrings.h>
30 #endif /* defined(__cplusplus) */
34 #ifndef NO_SHLWAPI_REG
36 /* Registry functions */
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)
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)
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)
57 _Out_writes_bytes_opt_(*pcbData
) LPVOID
,
58 _Inout_opt_ LPDWORD pcbData
);
67 _Out_writes_bytes_opt_(*pcbData
) LPVOID
,
68 _Inout_opt_ LPDWORD pcbData
);
70 #define SHGetValue WINELIB_NAME_AW(SHGetValue)
79 _In_reads_bytes_opt_(cbData
) LPCVOID
,
89 _In_reads_bytes_opt_(cbData
) LPCVOID
,
92 #define SHSetValue WINELIB_NAME_AW(SHSetValue)
101 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
102 _Inout_opt_ LPDWORD pcbData
);
111 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
112 _Inout_opt_ LPDWORD pcbData
);
114 #define SHQueryValueEx WINELIB_NAME_AW(SHQueryValueEx)
121 _Out_writes_(*pcchName
) LPSTR
,
122 _Inout_ LPDWORD pcchName
);
129 _Out_writes_(*pcchName
) LPWSTR
,
130 _Inout_ LPDWORD pcchName
);
132 #define SHEnumKeyEx WINELIB_NAME_AW(SHEnumKeyEx)
139 _Out_writes_opt_(*pcchValueName
) LPSTR
,
140 _Inout_opt_ LPDWORD pcchValueName
,
142 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
143 _Inout_opt_ LPDWORD pcbData
);
150 _Out_writes_opt_(*pcchValueName
) LPWSTR
,
151 _Inout_opt_ LPDWORD pcchValueName
,
153 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
154 _Inout_opt_ LPDWORD pcbData
);
156 #define SHEnumValue WINELIB_NAME_AW(SHEnumValue)
176 #define SHQueryInfoKey WINELIB_NAME_AW(SHQueryInfoKey)
184 _Out_writes_(MAX_PATH
) LPSTR
,
193 _Out_writes_(MAX_PATH
) LPWSTR
,
196 #define SHRegGetPath WINELIB_NAME_AW(SHRegGetPath)
216 #define SHRegSetPath WINELIB_NAME_AW(SHRegSetPath)
234 #define SHCopyKey WINELIB_NAME_AW(SHCopyKey)
236 HKEY WINAPI
SHRegDuplicateHKey(_In_ HKEY
);
238 /* SHRegGetValue flags */
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
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
253 #define SRRF_RM_ANY 0
254 #define SRRF_RM_NORMAL 0x10000
255 #define SRRF_RM_SAFE 0x20000
256 #define SRRF_RM_SAFENETWORK 0x40000
258 #define SRRF_NOEXPAND 0x10000000
259 #define SRRF_ZEROONFAILURE 0x20000000
260 #define SRRF_NOVIRT 0x40000000
270 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
271 _Inout_opt_ LPDWORD pcbData
);
281 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
282 _Inout_opt_ LPDWORD pcbData
);
284 #define SHRegGetValue WINELIB_NAME_AW(SHRegGetValue)
286 /* Undocumented registry functions */
288 DWORD WINAPI
SHDeleteOrphanKeyA(HKEY
,LPCSTR
);
289 DWORD WINAPI
SHDeleteOrphanKeyW(HKEY
,LPCWSTR
);
290 #define SHDeleteOrphanKey WINELIB_NAME_AW(SHDeleteOrphanKey)
293 /* User registry functions */
297 SHREGDEL_DEFAULT
= 0,
299 SHREGDEL_HKLM
= 0x10,
300 SHREGDEL_BOTH
= SHREGDEL_HKLM
| SHREGDEL_HKCU
305 SHREGENUM_DEFAULT
= 0,
306 SHREGENUM_HKCU
= 0x1,
307 SHREGENUM_HKLM
= 0x10,
308 SHREGENUM_BOTH
= SHREGENUM_HKLM
| SHREGENUM_HKCU
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)
317 typedef HANDLE HUSKEY
;
318 typedef HUSKEY
*PHUSKEY
;
338 #define SHRegCreateUSKey WINELIB_NAME_AW(SHRegCreateUSKey)
358 #define SHRegOpenUSKey WINELIB_NAME_AW(SHRegOpenUSKey)
366 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
367 _Inout_opt_ LPDWORD pcbData
,
369 _In_reads_bytes_opt_(dwDefaultDataSize
) LPVOID
,
370 _In_opt_ DWORD dwDefaultDataSize
);
378 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
379 _Inout_opt_ LPDWORD pcbData
,
381 _In_reads_bytes_opt_(dwDefaultDataSize
) LPVOID
,
382 _In_opt_ DWORD dwDefaultDataSize
);
384 #define SHRegQueryUSValue WINELIB_NAME_AW(SHRegQueryUSValue)
392 _In_reads_bytes_(cbData
) LPVOID
,
402 _In_reads_bytes_(cbData
) LPVOID
,
406 #define SHRegWriteUSValue WINELIB_NAME_AW(SHRegWriteUSValue)
413 _In_ SHREGDEL_FLAGS
);
420 _In_ SHREGDEL_FLAGS
);
422 #define SHRegDeleteUSValue WINELIB_NAME_AW(SHRegDeleteUSValue)
426 SHRegDeleteEmptyUSKeyA(
429 _In_ SHREGDEL_FLAGS
);
433 SHRegDeleteEmptyUSKeyW(
436 _In_ SHREGDEL_FLAGS
);
438 #define SHRegDeleteEmptyUSKey WINELIB_NAME_AW(SHRegDeleteEmptyUSKey)
445 _Out_writes_to_(*pcchName
, *pcchName
) LPSTR
,
446 _Inout_ LPDWORD pcchName
,
447 _In_ SHREGENUM_FLAGS
);
454 _Out_writes_to_(*pcchName
, *pcchName
) LPWSTR
,
455 _Inout_ LPDWORD pcchName
,
456 _In_ SHREGENUM_FLAGS
);
458 #define SHRegEnumUSKey WINELIB_NAME_AW(SHRegEnumUSKey)
465 _Out_writes_to_(*pcchValueName
, *pcchValueName
) LPSTR
,
466 _Inout_ LPDWORD pcchValueName
,
468 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
469 _Inout_opt_ LPDWORD pcbData
,
470 _In_ SHREGENUM_FLAGS
);
477 _Out_writes_to_(*pcchValueName
, *pcchValueName
) LPWSTR
,
478 _Inout_ LPDWORD pcchValueName
,
480 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
481 _Inout_opt_ LPDWORD pcbData
,
482 _In_ SHREGENUM_FLAGS
);
484 #define SHRegEnumUSValue WINELIB_NAME_AW(SHRegEnumUSValue)
488 SHRegQueryInfoUSKeyA(
494 _In_ SHREGENUM_FLAGS
);
498 SHRegQueryInfoUSKeyW(
504 _In_ SHREGENUM_FLAGS
);
506 #define SHRegQueryInfoUSKey WINELIB_NAME_AW(SHRegQueryInfoUSKey)
508 LONG WINAPI
SHRegCloseUSKey(_In_ HUSKEY
);
516 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
517 _Inout_opt_ LPDWORD pcbData
,
519 _In_reads_bytes_opt_(dwDefaultDataSize
) LPVOID
,
520 _In_ DWORD dwDefaultDataSize
);
528 _Out_writes_bytes_to_opt_(*pcbData
, *pcbData
) LPVOID
,
529 _Inout_opt_ LPDWORD pcbData
,
531 _In_reads_bytes_opt_(dwDefaultDataSize
) LPVOID
,
532 _In_ DWORD dwDefaultDataSize
);
534 #define SHRegGetUSValue WINELIB_NAME_AW(SHRegGetUSValue)
542 _In_reads_bytes_opt_(cbData
) LPVOID
,
543 _In_opt_ DWORD cbData
,
552 _In_reads_bytes_opt_(cbData
) LPVOID
,
553 _In_opt_ DWORD cbData
,
556 #define SHRegSetUSValue WINELIB_NAME_AW(SHRegSetUSValue)
560 SHRegGetBoolUSValueA(
568 SHRegGetBoolUSValueW(
574 #define SHRegGetBoolUSValue WINELIB_NAME_AW(SHRegGetBoolUSValue)
576 int WINAPI
SHRegGetIntW(_In_ HKEY
, _In_opt_ LPCWSTR
, _In_
int);
578 /* IQueryAssociation and helpers */
581 ASSOCF_NONE
= 0x0000,
582 ASSOCF_INIT_NOREMAPCLSID
= 0x0001, /* Don't map clsid->progid */
583 ASSOCF_INIT_BYEXENAME
= 0x0002, /* .exe name given */
584 ASSOCF_OPEN_BYEXENAME
= 0x0002, /* Synonym */
585 ASSOCF_INIT_DEFAULTTOSTAR
= 0x0004, /* Use * as base */
586 ASSOCF_INIT_DEFAULTTOFOLDER
= 0x0008, /* Use folder as base */
587 ASSOCF_NOUSERSETTINGS
= 0x0010, /* No HKCU reads */
588 ASSOCF_NOTRUNCATE
= 0x0020, /* Don't truncate return */
589 ASSOCF_VERIFY
= 0x0040, /* Verify data */
590 ASSOCF_REMAPRUNDLL
= 0x0080, /* Get rundll args */
591 ASSOCF_NOFIXUPS
= 0x0100, /* Don't fixup errors */
592 ASSOCF_IGNOREBASECLASS
= 0x0200, /* Don't read baseclass */
593 ASSOCF_INIT_IGNOREUNKNOWN
= 0x0400, /* Fail for unknown progid */
594 ASSOCF_INIT_FIXED_PROGID
= 0x0800, /* Used passed string as progid, don't try to map it */
595 ASSOCF_IS_PROTOCOL
= 0x1000, /* Treat as protocol, that should be mapped */
596 ASSOCF_INIT_FOR_FILE
= 0x2000, /* progid is for file extension association */
599 typedef DWORD ASSOCF
;
603 ASSOCSTR_COMMAND
= 1, /* Verb command */
604 ASSOCSTR_EXECUTABLE
, /* .exe from command string */
605 ASSOCSTR_FRIENDLYDOCNAME
, /* Friendly doc type name */
606 ASSOCSTR_FRIENDLYAPPNAME
, /* Friendly .exe name */
607 ASSOCSTR_NOOPEN
, /* noopen value */
608 ASSOCSTR_SHELLNEWVALUE
, /* Use shellnew key */
609 ASSOCSTR_DDECOMMAND
, /* DDE command template */
610 ASSOCSTR_DDEIFEXEC
, /* DDE command for process create */
611 ASSOCSTR_DDEAPPLICATION
, /* DDE app name */
612 ASSOCSTR_DDETOPIC
, /* DDE topic */
613 ASSOCSTR_INFOTIP
, /* Infotip */
614 ASSOCSTR_QUICKTIP
, /* Quick infotip */
615 ASSOCSTR_TILEINFO
, /* Properties for tileview */
616 ASSOCSTR_CONTENTTYPE
, /* Mimetype */
617 ASSOCSTR_DEFAULTICON
, /* Icon */
618 ASSOCSTR_SHELLEXTENSION
, /* GUID for shell extension handler */
624 ASSOCKEY_SHELLEXECCLASS
= 1, /* Key for ShellExec */
625 ASSOCKEY_APP
, /* Application */
626 ASSOCKEY_CLASS
, /* Progid or class */
627 ASSOCKEY_BASECLASS
, /* Base class */
633 ASSOCDATA_MSIDESCRIPTOR
= 1, /* Component descriptor */
634 ASSOCDATA_NOACTIVATEHANDLER
, /* Don't activate */
635 ASSOCDATA_QUERYCLASSSTORE
, /* Look in Class Store */
636 ASSOCDATA_HASPERUSERASSOC
, /* Use user association */
637 ASSOCDATA_EDITFLAGS
, /* Edit flags */
638 ASSOCDATA_VALUE
, /* pszExtra is value */
647 typedef struct IQueryAssociations
*LPQUERYASSOCIATIONS
;
649 #define INTERFACE IQueryAssociations
650 DECLARE_INTERFACE_(IQueryAssociations
,IUnknown
)
652 /*** IUnknown methods ***/
653 STDMETHOD_(HRESULT
,QueryInterface
)(THIS_ REFIID riid
, void** ppvObject
) PURE
;
654 STDMETHOD_(ULONG
,AddRef
)(THIS
) PURE
;
655 STDMETHOD_(ULONG
,Release
)(THIS
) PURE
;
656 /*** IQueryAssociations methods ***/
657 STDMETHOD(Init
)(THIS_ _In_ ASSOCF flags
, _In_opt_ LPCWSTR pszAssoc
, _In_opt_ HKEY hkProgid
, _In_opt_ HWND hwnd
) PURE
;
658 STDMETHOD(GetString
)(THIS_ _In_ ASSOCF flags
, _In_ ASSOCSTR str
, _In_opt_ LPCWSTR pszExtra
, _Out_writes_opt_(*pcchOut
) LPWSTR pszOut
, _Inout_ DWORD
*pcchOut
) PURE
;
659 STDMETHOD(GetKey
)(THIS_ _In_ ASSOCF flags
, _In_ ASSOCKEY key
, _In_opt_ LPCWSTR pszExtra
, _Out_ HKEY
*phkeyOut
) PURE
;
660 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
;
661 STDMETHOD(GetEnum
)(THIS_ _In_ ASSOCF flags
, _In_ ASSOCENUM assocenum
, _In_opt_ LPCWSTR pszExtra
, _In_ REFIID riid
, _Outptr_ LPVOID
*ppvOut
) PURE
;
665 #if !defined(__cplusplus) || defined(CINTERFACE)
666 #define IQueryAssociations_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
667 #define IQueryAssociations_AddRef(p) (p)->lpVtbl->AddRef(p)
668 #define IQueryAssociations_Release(p) (p)->lpVtbl->Release(p)
669 #define IQueryAssociations_Init(p,a,b,c,d) (p)->lpVtbl->Init(p,a,b,c,d)
670 #define IQueryAssociations_GetString(p,a,b,c,d,e) (p)->lpVtbl->GetString(p,a,b,c,d,e)
671 #define IQueryAssociations_GetKey(p,a,b,c,d) (p)->lpVtbl->GetKey(p,a,b,c,d)
672 #define IQueryAssociations_GetData(p,a,b,c,d,e) (p)->lpVtbl->GetData(p,a,b,c,d,e)
673 #define IQueryAssociations_GetEnum(p,a,b,c,d,e) (p)->lpVtbl->GetEnum(p,a,b,c,d,e)
676 HRESULT WINAPI
AssocCreate(_In_ CLSID
, _In_ REFIID
, _Outptr_ LPVOID
*);
685 _Out_writes_opt_(*pcchOut
) LPSTR
,
686 _Inout_ LPDWORD pcchOut
);
695 _Out_writes_opt_(*pcchOut
) LPWSTR
,
696 _Inout_ LPDWORD pcchOut
);
698 #define AssocQueryString WINELIB_NAME_AW(AssocQueryString)
702 AssocQueryStringByKeyA(
707 _Out_writes_opt_(*pcchOut
) LPSTR
,
708 _Inout_ LPDWORD pcchOut
);
712 AssocQueryStringByKeyW(
717 _Out_writes_opt_(*pcchOut
) LPWSTR
,
718 _Inout_ LPDWORD pcchOut
);
720 #define AssocQueryStringByKey WINELIB_NAME_AW(AssocQueryStringByKey)
740 #define AssocQueryKey WINELIB_NAME_AW(AssocQueryKey)
742 BOOL WINAPI
AssocIsDangerous(_In_ LPCWSTR
);
744 #endif /* NO_SHLWAPI_REG */
746 void WINAPI
IUnknown_Set(_Inout_ IUnknown
**ppunk
, _In_opt_ IUnknown
*punk
);
747 void WINAPI
IUnknown_AtomicRelease(_Inout_opt_ IUnknown
**punk
);
748 HRESULT WINAPI
IUnknown_GetWindow(_In_ IUnknown
*punk
, _Out_ HWND
*phwnd
);
754 _In_opt_ IUnknown
*punkSite
);
761 _Outptr_
void **ppv
);
765 IUnknown_QueryService(
766 _In_opt_ IUnknown
*punk
,
767 _In_ REFGUID guidService
,
769 _Outptr_
void **ppvOut
);
772 #ifndef NO_SHLWAPI_PATH
774 /* GetPathCharType return flags */
775 #define GCT_INVALID 0x0
776 #define GCT_LFNCHAR 0x1
777 #define GCT_SHORTCHAR 0x2
779 #define GCT_SEPARATOR 0x8
781 LPSTR WINAPI
PathAddBackslashA(_Inout_updates_(MAX_PATH
) LPSTR
);
782 LPWSTR WINAPI
PathAddBackslashW(_Inout_updates_(MAX_PATH
) LPWSTR
);
783 #define PathAddBackslash WINELIB_NAME_AW(PathAddBackslash)
788 _Inout_updates_(MAX_PATH
) LPSTR
,
794 _Inout_updates_(MAX_PATH
) LPWSTR
,
797 #define PathAddExtension WINELIB_NAME_AW(PathAddExtension)
799 BOOL WINAPI
PathAppendA(_Inout_updates_(MAX_PATH
) LPSTR
, _In_ LPCSTR
);
800 BOOL WINAPI
PathAppendW(_Inout_updates_(MAX_PATH
) LPWSTR
, _In_ LPCWSTR
);
801 #define PathAppend WINELIB_NAME_AW(PathAppend)
803 LPSTR WINAPI
PathBuildRootA(_Out_writes_(4) LPSTR
, int);
804 LPWSTR WINAPI
PathBuildRootW(_Out_writes_(4) LPWSTR
, int);
805 #define PathBuildRoot WINELIB_NAME_AW(PathBuiltRoot)
807 BOOL WINAPI
PathCanonicalizeA(_Out_writes_(MAX_PATH
) LPSTR
, _In_ LPCSTR
);
808 BOOL WINAPI
PathCanonicalizeW(_Out_writes_(MAX_PATH
) LPWSTR
, _In_ LPCWSTR
);
809 #define PathCanonicalize WINELIB_NAME_AW(PathCanonicalize)
814 _Out_writes_(MAX_PATH
) LPSTR
,
821 _Out_writes_(MAX_PATH
) LPWSTR
,
825 #define PathCombine WINELIB_NAME_AW(PathCombine)
831 _Inout_updates_(MAX_PATH
) LPSTR
,
838 _Inout_updates_(MAX_PATH
) LPWSTR
,
841 #define PathCompactPath WINELIB_NAME_AW(PathCompactPath)
846 _Out_writes_(cchMax
) LPSTR
,
854 _Out_writes_(cchMax
) LPWSTR
,
859 #define PathCompactPathEx WINELIB_NAME_AW(PathCompactPathEx)
866 _Out_writes_opt_(MAX_PATH
) LPSTR
);
873 _Out_writes_opt_(MAX_PATH
) LPWSTR
);
875 #define PathCommonPrefix WINELIB_NAME_AW(PathCommonPrefix)
881 _Out_writes_to_(*pcchPath
, *pcchPath
) LPSTR
,
882 _Inout_ LPDWORD pcchPath
,
889 _Out_writes_to_(*pcchPath
, *pcchPath
) LPWSTR
,
890 _Inout_ LPDWORD pcchPath
,
893 #define PathCreateFromUrl WINELIB_NAME_AW(PathCreateFromUrl)
895 HRESULT WINAPI
PathCreateFromUrlAlloc(_In_ LPCWSTR
, _Outptr_ LPWSTR
*, DWORD
);
897 BOOL WINAPI
PathFileExistsA(_In_ LPCSTR
);
898 BOOL WINAPI
PathFileExistsW(_In_ LPCWSTR
);
899 #define PathFileExists WINELIB_NAME_AW(PathFileExists)
901 BOOL WINAPI
PathFileExistsAndAttributesA(LPCSTR
,DWORD
*);
902 BOOL WINAPI
PathFileExistsAndAttributesW(LPCWSTR
,DWORD
*);
903 #define PathFileExistsAndAttributes WINELIB_NAME_AW(PathFileExistsAndAttributes)
905 LPSTR WINAPI
PathFindExtensionA(_In_ LPCSTR
);
906 LPWSTR WINAPI
PathFindExtensionW(_In_ LPCWSTR
);
907 #define PathFindExtension WINELIB_NAME_AW(PathFindExtension)
909 LPSTR WINAPI
PathFindFileNameA(_In_ LPCSTR
);
910 LPWSTR WINAPI
PathFindFileNameW(_In_ LPCWSTR
);
911 #define PathFindFileName WINELIB_NAME_AW(PathFindFileName)
913 LPSTR WINAPI
PathFindNextComponentA(_In_ LPCSTR
);
914 LPWSTR WINAPI
PathFindNextComponentW(_In_ LPCWSTR
);
915 #define PathFindNextComponent WINELIB_NAME_AW(PathFindNextComponent)
917 BOOL WINAPI
PathFindOnPathA(_Inout_updates_(MAX_PATH
) LPSTR
, _In_opt_ LPCSTR
*);
918 BOOL WINAPI
PathFindOnPathW(_Inout_updates_(MAX_PATH
) LPWSTR
, _In_opt_ LPCWSTR
*);
919 #define PathFindOnPath WINELIB_NAME_AW(PathFindOnPath)
921 LPSTR WINAPI
PathGetArgsA(_In_ LPCSTR
);
922 LPWSTR WINAPI
PathGetArgsW(_In_ LPCWSTR
);
923 #define PathGetArgs WINELIB_NAME_AW(PathGetArgs)
925 UINT WINAPI
PathGetCharTypeA(_In_ UCHAR
);
926 UINT WINAPI
PathGetCharTypeW(_In_ WCHAR
);
927 #define PathGetCharType WINELIB_NAME_AW(PathGetCharType)
929 int WINAPI
PathGetDriveNumberA(_In_ LPCSTR
);
930 int WINAPI
PathGetDriveNumberW(_In_ LPCWSTR
);
931 #define PathGetDriveNumber WINELIB_NAME_AW(PathGetDriveNumber)
933 BOOL WINAPI
PathIsDirectoryA(_In_ LPCSTR
);
934 BOOL WINAPI
PathIsDirectoryW(_In_ LPCWSTR
);
935 #define PathIsDirectory WINELIB_NAME_AW(PathIsDirectory)
937 BOOL WINAPI
PathIsDirectoryEmptyA(_In_ LPCSTR
);
938 BOOL WINAPI
PathIsDirectoryEmptyW(_In_ LPCWSTR
);
939 #define PathIsDirectoryEmpty WINELIB_NAME_AW(PathIsDirectoryEmpty)
941 BOOL WINAPI
PathIsFileSpecA(_In_ LPCSTR
);
942 BOOL WINAPI
PathIsFileSpecW(_In_ LPCWSTR
);
943 #define PathIsFileSpec WINELIB_NAME_AW(PathIsFileSpec);
945 BOOL WINAPI
PathIsPrefixA(_In_ LPCSTR
, _In_ LPCSTR
);
946 BOOL WINAPI
PathIsPrefixW(_In_ LPCWSTR
, _In_ LPCWSTR
);
947 #define PathIsPrefix WINELIB_NAME_AW(PathIsPrefix)
949 BOOL WINAPI
PathIsRelativeA(_In_ LPCSTR
);
950 BOOL WINAPI
PathIsRelativeW(_In_ LPCWSTR
);
951 #define PathIsRelative WINELIB_NAME_AW(PathIsRelative)
953 BOOL WINAPI
PathIsRootA(_In_ LPCSTR
);
954 BOOL WINAPI
PathIsRootW(_In_ LPCWSTR
);
955 #define PathIsRoot WINELIB_NAME_AW(PathIsRoot)
957 BOOL WINAPI
PathIsSameRootA(_In_ LPCSTR
, _In_ LPCSTR
);
958 BOOL WINAPI
PathIsSameRootW(_In_ LPCWSTR
, _In_ LPCWSTR
);
959 #define PathIsSameRoot WINELIB_NAME_AW(PathIsSameRoot)
961 BOOL WINAPI
PathIsUNCA(_In_ LPCSTR
);
962 BOOL WINAPI
PathIsUNCW(_In_ LPCWSTR
);
963 #define PathIsUNC WINELIB_NAME_AW(PathIsUNC)
965 BOOL WINAPI
PathIsUNCServerA(_In_ LPCSTR
);
966 BOOL WINAPI
PathIsUNCServerW(_In_ LPCWSTR
);
967 #define PathIsUNCServer WINELIB_NAME_AW(PathIsUNCServer)
969 BOOL WINAPI
PathIsUNCServerShareA(_In_ LPCSTR
);
970 BOOL WINAPI
PathIsUNCServerShareW(_In_ LPCWSTR
);
971 #define PathIsUNCServerShare WINELIB_NAME_AW(PathIsUNCServerShare)
973 BOOL WINAPI
PathIsContentTypeA(_In_ LPCSTR
, _In_ LPCSTR
);
974 BOOL WINAPI
PathIsContentTypeW(_In_ LPCWSTR
, _In_ LPCWSTR
);
975 #define PathIsContentType WINELIB_NAME_AW(PathIsContentType)
977 BOOL WINAPI
PathIsURLA(_In_ LPCSTR
);
978 BOOL WINAPI
PathIsURLW(_In_ LPCWSTR
);
979 #define PathIsURL WINELIB_NAME_AW(PathIsURL)
981 BOOL WINAPI
PathMakePrettyA(_Inout_ LPSTR
);
982 BOOL WINAPI
PathMakePrettyW(_Inout_ LPWSTR
);
983 #define PathMakePretty WINELIB_NAME_AW(PathMakePretty)
985 BOOL WINAPI
PathMatchSpecA(_In_ LPCSTR
, _In_ LPCSTR
);
986 BOOL WINAPI
PathMatchSpecW(_In_ LPCWSTR
, _In_ LPCWSTR
);
987 #define PathMatchSpec WINELIB_NAME_AW(PathMatchSpec)
989 int WINAPI
PathParseIconLocationA(_Inout_ LPSTR
);
990 int WINAPI
PathParseIconLocationW(_Inout_ LPWSTR
);
991 #define PathParseIconLocation WINELIB_NAME_AW(PathParseIconLocation)
993 VOID WINAPI
PathQuoteSpacesA(_Inout_updates_(MAX_PATH
) LPSTR
);
994 VOID WINAPI
PathQuoteSpacesW(_Inout_updates_(MAX_PATH
) LPWSTR
);
995 #define PathQuoteSpaces WINELIB_NAME_AW(PathQuoteSpaces)
1000 _Out_writes_(MAX_PATH
) LPSTR
,
1008 PathRelativePathToW(
1009 _Out_writes_(MAX_PATH
) LPWSTR
,
1015 #define PathRelativePathTo WINELIB_NAME_AW(PathRelativePathTo)
1017 VOID WINAPI
PathRemoveArgsA(_Inout_ LPSTR
);
1018 VOID WINAPI
PathRemoveArgsW(_Inout_ LPWSTR
);
1019 #define PathRemoveArgs WINELIB_NAME_AW(PathRemoveArgs)
1021 LPSTR WINAPI
PathRemoveBackslashA(_Inout_ LPSTR
);
1022 LPWSTR WINAPI
PathRemoveBackslashW(_Inout_ LPWSTR
);
1023 #define PathRemoveBackslash WINELIB_NAME_AW(PathRemoveBackslash)
1025 VOID WINAPI
PathRemoveBlanksA(_Inout_ LPSTR
);
1026 VOID WINAPI
PathRemoveBlanksW(_Inout_ LPWSTR
);
1027 #define PathRemoveBlanks WINELIB_NAME_AW(PathRemoveBlanks)
1029 VOID WINAPI
PathRemoveExtensionA(_Inout_ LPSTR
);
1030 VOID WINAPI
PathRemoveExtensionW(_Inout_ LPWSTR
);
1031 #define PathRemoveExtension WINELIB_NAME_AW(PathRemoveExtension)
1033 BOOL WINAPI
PathRemoveFileSpecA(_Inout_ LPSTR
);
1034 BOOL WINAPI
PathRemoveFileSpecW(_Inout_ LPWSTR
);
1035 #define PathRemoveFileSpec WINELIB_NAME_AW(PathRemoveFileSpec)
1039 PathRenameExtensionA(
1040 _Inout_updates_(MAX_PATH
) LPSTR
,
1045 PathRenameExtensionW(
1046 _Inout_updates_(MAX_PATH
) LPWSTR
,
1049 #define PathRenameExtension WINELIB_NAME_AW(PathRenameExtension)
1053 PathSearchAndQualifyA(
1055 _Out_writes_(cchBuf
) LPSTR
,
1060 PathSearchAndQualifyW(
1062 _Out_writes_(cchBuf
) LPWSTR
,
1065 #define PathSearchAndQualify WINELIB_NAME_AW(PathSearchAndQualify)
1067 VOID WINAPI
PathSetDlgItemPathA(_In_ HWND
, int, LPCSTR
);
1068 VOID WINAPI
PathSetDlgItemPathW(_In_ HWND
, int, LPCWSTR
);
1069 #define PathSetDlgItemPath WINELIB_NAME_AW(PathSetDlgItemPath)
1071 LPSTR WINAPI
PathSkipRootA(_In_ LPCSTR
);
1072 LPWSTR WINAPI
PathSkipRootW(_In_ LPCWSTR
);
1073 #define PathSkipRoot WINELIB_NAME_AW(PathSkipRoot)
1075 VOID WINAPI
PathStripPathA(_Inout_ LPSTR
);
1076 VOID WINAPI
PathStripPathW(_Inout_ LPWSTR
);
1077 #define PathStripPath WINELIB_NAME_AW(PathStripPath)
1079 BOOL WINAPI
PathStripToRootA(_Inout_ LPSTR
);
1080 BOOL WINAPI
PathStripToRootW(_Inout_ LPWSTR
);
1081 #define PathStripToRoot WINELIB_NAME_AW(PathStripToRoot)
1083 VOID WINAPI
PathUnquoteSpacesA(_Inout_ LPSTR
);
1084 VOID WINAPI
PathUnquoteSpacesW(_Inout_ LPWSTR
);
1085 #define PathUnquoteSpaces WINELIB_NAME_AW(PathUnquoteSpaces)
1087 BOOL WINAPI
PathMakeSystemFolderA(_In_ LPCSTR
);
1088 BOOL WINAPI
PathMakeSystemFolderW(_In_ LPCWSTR
);
1089 #define PathMakeSystemFolder WINELIB_NAME_AW(PathMakeSystemFolder)
1091 BOOL WINAPI
PathUnmakeSystemFolderA(_In_ LPCSTR
);
1092 BOOL WINAPI
PathUnmakeSystemFolderW(_In_ LPCWSTR
);
1093 #define PathUnmakeSystemFolder WINELIB_NAME_AW(PathUnmakeSystemFolder)
1095 BOOL WINAPI
PathIsSystemFolderA(_In_opt_ LPCSTR
, _In_ DWORD
);
1096 BOOL WINAPI
PathIsSystemFolderW(_In_opt_ LPCWSTR
, _In_ DWORD
);
1097 #define PathIsSystemFolder WINELIB_NAME_AW(PathIsSystemFolder)
1099 BOOL WINAPI
PathIsNetworkPathA(_In_ LPCSTR
);
1100 BOOL WINAPI
PathIsNetworkPathW(_In_ LPCWSTR
);
1101 #define PathIsNetworkPath WINELIB_NAME_AW(PathIsNetworkPath)
1103 BOOL WINAPI
PathIsLFNFileSpecA(_In_ LPCSTR
);
1104 BOOL WINAPI
PathIsLFNFileSpecW(_In_ LPCWSTR
);
1105 #define PathIsLFNFileSpec WINELIB_NAME_AW(PathIsLFNFileSpec)
1109 PathFindSuffixArrayA(
1111 _In_reads_(iArraySize
) LPCSTR
*,
1116 PathFindSuffixArrayW(
1118 _In_reads_(iArraySize
) LPCWSTR
*,
1121 #define PathFindSuffixArray WINELIB_NAME_AW(PathFindSuffixArray)
1123 VOID WINAPI
PathUndecorateA(_Inout_ LPSTR
);
1124 VOID WINAPI
PathUndecorateW(_Inout_ LPWSTR
);
1125 #define PathUndecorate WINELIB_NAME_AW(PathUndecorate)
1129 PathUnExpandEnvStringsA(
1131 _Out_writes_(cchBuf
) LPSTR
,
1136 PathUnExpandEnvStringsW(
1138 _Out_writes_(cchBuf
) LPWSTR
,
1141 #define PathUnExpandEnvStrings WINELIB_NAME_AW(PathUnExpandEnvStrings)
1145 URL_SCHEME_INVALID
= -1,
1146 URL_SCHEME_UNKNOWN
= 0,
1161 URL_SCHEME_JAVASCRIPT
,
1162 URL_SCHEME_VBSCRIPT
,
1165 URL_SCHEME_MSSHELLROOTED
,
1166 URL_SCHEME_MSSHELLIDLIST
,
1168 URL_SCHEME_MSSHELLDEVICE
,
1169 URL_SCHEME_WILDCARD
,
1170 URL_SCHEME_SEARCH_MS
,
1172 URL_SCHEME_KNOWNFOLDER
,
1176 /* These are used by UrlGetPart routine */
1179 URL_PART_SCHEME
= 1,
1187 #define URL_PARTFLAG_KEEPSCHEME 0x00000001
1189 /* These are used by the UrlIs... routines */
1200 /* This is used by the UrlApplyScheme... routines */
1201 #define URL_APPLY_FORCEAPPLY 0x00000008
1202 #define URL_APPLY_GUESSFILE 0x00000004
1203 #define URL_APPLY_GUESSSCHEME 0x00000002
1204 #define URL_APPLY_DEFAULT 0x00000001
1206 /* The following are used by UrlEscape..., UrlUnEscape...,
1207 * UrlCanonicalize..., and UrlCombine... routines
1209 #define URL_WININET_COMPATIBILITY 0x80000000
1210 #define URL_PLUGGABLE_PROTOCOL 0x40000000
1211 #define URL_ESCAPE_UNSAFE 0x20000000
1212 #define URL_UNESCAPE 0x10000000
1214 #define URL_DONT_SIMPLIFY 0x08000000
1215 #define URL_NO_META URL_DONT_SIMPLIFY
1216 #define URL_ESCAPE_SPACES_ONLY 0x04000000
1217 #define URL_DONT_ESCAPE_EXTRA_INFO 0x02000000
1218 #define URL_DONT_UNESCAPE_EXTRA_INFO URL_DONT_ESCAPE_EXTRA_INFO
1219 #define URL_BROWSER_MODE URL_DONT_ESCAPE_EXTRA_INFO
1221 #define URL_INTERNAL_PATH 0x00800000 /* Will escape #'s in paths */
1222 #define URL_UNESCAPE_HIGH_ANSI_ONLY 0x00400000
1223 #define URL_CONVERT_IF_DOSPATH 0x00200000
1224 #define URL_UNESCAPE_INPLACE 0x00100000
1226 #define URL_FILE_USE_PATHURL 0x00010000
1227 #define URL_ESCAPE_AS_UTF8 0x00040000
1229 #define URL_ESCAPE_SEGMENT_ONLY 0x00002000
1230 #define URL_ESCAPE_PERCENT 0x00001000
1236 _Out_writes_(*pcchOut
) LPSTR
,
1237 _Inout_ LPDWORD pcchOut
,
1244 _Out_writes_(*pcchOut
) LPWSTR
,
1245 _Inout_ LPDWORD pcchOut
,
1248 #define UrlApplyScheme WINELIB_NAME_AW(UrlApplyScheme)
1254 _Out_writes_to_(*pcchCanonicalized
, *pcchCanonicalized
) LPSTR
,
1255 _Inout_ LPDWORD pcchCanonicalized
,
1262 _Out_writes_to_(*pcchCanonicalized
, *pcchCanonicalized
) LPWSTR
,
1263 _Inout_ LPDWORD pcchCanonicalized
,
1266 #define UrlCanonicalize WINELIB_NAME_AW(UrlCanonicalize)
1273 _Out_writes_to_opt_(*pcchCombined
, *pcchCombined
) LPSTR
,
1274 _Inout_ LPDWORD pcchCombined
,
1282 _Out_writes_to_opt_(*pcchCombined
, *pcchCombined
) LPWSTR
,
1283 _Inout_ LPDWORD pcchCombined
,
1286 #define UrlCombine WINELIB_NAME_AW(UrlCombine)
1288 INT WINAPI
UrlCompareA(_In_ LPCSTR
, _In_ LPCSTR
, BOOL
);
1289 INT WINAPI
UrlCompareW(_In_ LPCWSTR
, _In_ LPCWSTR
, BOOL
);
1290 #define UrlCompare WINELIB_NAME_AW(UrlCompare)
1296 _Out_writes_to_(*pcchEscaped
, *pcchEscaped
) LPSTR
,
1297 _Inout_ LPDWORD pcchEscaped
,
1304 _Out_writes_to_(*pcchEscaped
, *pcchEscaped
) LPWSTR
,
1305 _Inout_ LPDWORD pcchEscaped
,
1308 #define UrlEscape WINELIB_NAME_AW(UrlEscape)
1310 #define UrlEscapeSpacesA(x,y,z) UrlCanonicalizeA(x, y, z, \
1311 URL_DONT_ESCAPE_EXTRA_INFO|URL_ESCAPE_SPACES_ONLY)
1312 #define UrlEscapeSpacesW(x,y,z) UrlCanonicalizeW(x, y, z, \
1313 URL_DONT_ESCAPE_EXTRA_INFO|URL_ESCAPE_SPACES_ONLY)
1314 #define UrlEscapeSpaces WINELIB_NAME_AW(UrlEscapeSpaces)
1316 LPCSTR WINAPI
UrlGetLocationA(_In_ LPCSTR
);
1317 LPCWSTR WINAPI
UrlGetLocationW(_In_ LPCWSTR
);
1318 #define UrlGetLocation WINELIB_NAME_AW(UrlGetLocation)
1324 _Out_writes_(*pcchOut
) LPSTR
,
1325 _Inout_ LPDWORD pcchOut
,
1333 _Out_writes_(*pcchOut
) LPWSTR
,
1334 _Inout_ LPDWORD pcchOut
,
1338 #define UrlGetPart WINELIB_NAME_AW(UrlGetPart)
1343 _In_reads_bytes_(cbData
) const unsigned char *,
1345 _Out_writes_bytes_(cbHash
) unsigned char *lpDest
,
1352 _Out_writes_bytes_(cbHash
) unsigned char *,
1359 _Out_writes_bytes_(cbHash
) unsigned char *,
1362 #define UrlHash WINELIB_NAME_AW(UrlHash)
1364 BOOL WINAPI
UrlIsA(_In_ LPCSTR
, URLIS
);
1365 BOOL WINAPI
UrlIsW(_In_ LPCWSTR
, URLIS
);
1366 #define UrlIs WINELIB_NAME_AW(UrlIs)
1368 BOOL WINAPI
UrlIsNoHistoryA(_In_ LPCSTR
);
1369 BOOL WINAPI
UrlIsNoHistoryW(_In_ LPCWSTR
);
1370 #define UrlIsNoHistory WINELIB_NAME_AW(UrlIsNoHistory)
1372 BOOL WINAPI
UrlIsOpaqueA(_In_ LPCSTR
);
1373 BOOL WINAPI
UrlIsOpaqueW(_In_ LPCWSTR
);
1374 #define UrlIsOpaque WINELIB_NAME_AW(UrlIsOpaque)
1376 #define UrlIsFileUrlA(x) UrlIsA(x, URLIS_FILEURL)
1377 #define UrlIsFileUrlW(x) UrlIsW(x, URLIS_FILEURL)
1378 #define UrlIsFileUrl WINELIB_NAME_AW(UrlIsFileUrl)
1384 _Out_writes_to_opt_(*pcchUnescaped
, *pcchUnescaped
) LPSTR
,
1385 _Inout_opt_ LPDWORD pcchUnescaped
,
1392 _Out_writes_to_opt_(*pcchUnescaped
, *pcchUnescaped
) LPWSTR
,
1393 _Inout_opt_ LPDWORD pcchUnescaped
,
1396 #define UrlUnescape WINELIB_NAME_AW(UrlUnescape)
1398 #define UrlUnescapeInPlaceA(x,y) UrlUnescapeA(x, NULL, NULL, \
1399 y | URL_UNESCAPE_INPLACE)
1400 #define UrlUnescapeInPlaceW(x,y) UrlUnescapeW(x, NULL, NULL, \
1401 y | URL_UNESCAPE_INPLACE)
1402 #define UrlUnescapeInPlace WINELIB_NAME_AW(UrlUnescapeInPlace)
1408 _Out_writes_to_(*pcchUrl
, *pcchUrl
) LPSTR
,
1409 _Inout_ LPDWORD pcchUrl
,
1416 _Out_writes_to_(*pcchUrl
, *pcchUrl
) LPWSTR
,
1417 _Inout_ LPDWORD pcchUrl
,
1420 #define UrlCreateFromPath WINELIB_NAME_AW(UrlCreateFromPath)
1422 typedef struct tagPARSEDURLA
{
1429 } PARSEDURLA
, *PPARSEDURLA
;
1431 typedef struct tagPARSEDURLW
{
1433 LPCWSTR pszProtocol
;
1438 } PARSEDURLW
, *PPARSEDURLW
;
1440 HRESULT WINAPI
ParseURLA(_In_ LPCSTR pszUrl
, _Inout_ PARSEDURLA
*ppu
);
1441 HRESULT WINAPI
ParseURLW(_In_ LPCWSTR pszUrl
, _Inout_ PARSEDURLW
*ppu
);
1442 #define ParseURL WINELIB_NAME_AW(ParseUrl)
1444 #endif /* NO_SHLWAPI_PATH */
1447 /* String functions */
1448 #ifndef NO_SHLWAPI_STRFCNS
1450 /* StrToIntEx flags */
1451 #define STIF_DEFAULT 0x0L
1452 #define STIF_SUPPORT_HEX 0x1L
1454 BOOL WINAPI
ChrCmpIA (WORD
,WORD
);
1455 BOOL WINAPI
ChrCmpIW (WCHAR
,WCHAR
);
1456 #define ChrCmpI WINELIB_NAME_AW(ChrCmpI)
1458 INT WINAPI
StrCSpnA(_In_ LPCSTR
, _In_ LPCSTR
);
1459 INT WINAPI
StrCSpnW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1460 #define StrCSpn WINELIB_NAME_AW(StrCSpn)
1462 INT WINAPI
StrCSpnIA(_In_ LPCSTR
, _In_ LPCSTR
);
1463 INT WINAPI
StrCSpnIW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1464 #define StrCSpnI WINELIB_NAME_AW(StrCSpnI)
1466 #define StrCatA lstrcatA
1467 LPWSTR WINAPI
StrCatW(_Inout_ LPWSTR
, _In_ LPCWSTR
);
1468 #define StrCat WINELIB_NAME_AW(StrCat)
1473 _Inout_updates_(cchDestBuffSize
) LPSTR
,
1475 INT cchDestBuffSize
);
1480 _Inout_updates_(cchDestBuffSize
) LPWSTR
,
1482 INT cchDestBuffSize
);
1484 #define StrCatBuff WINELIB_NAME_AW(StrCatBuff)
1489 _Out_writes_(cchDst
) LPWSTR
,
1494 LPSTR WINAPI
StrChrA(_In_ LPCSTR
, WORD
);
1495 LPWSTR WINAPI
StrChrW(_In_ LPCWSTR
, WCHAR
);
1496 #define StrChr WINELIB_NAME_AW(StrChr)
1498 LPSTR WINAPI
StrChrIA(_In_ LPCSTR
, WORD
);
1499 LPWSTR WINAPI
StrChrIW(_In_ LPCWSTR
, WCHAR
);
1500 #define StrChrI WINELIB_NAME_AW(StrChrI)
1502 #define StrCmpA lstrcmpA
1503 int WINAPI
StrCmpW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1504 #define StrCmp WINELIB_NAME_AW(StrCmp)
1506 #define StrCmpIA lstrcmpiA
1507 int WINAPI
StrCmpIW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1508 #define StrCmpI WINELIB_NAME_AW(StrCmpI)
1510 #define StrCpyA lstrcpyA
1511 LPWSTR WINAPI
StrCpyW(_Out_ LPWSTR
, _In_ LPCWSTR
);
1512 #define StrCpy WINELIB_NAME_AW(StrCpy)
1514 #define StrCpyNA lstrcpynA
1515 LPWSTR WINAPI
StrCpyNW(_Out_writes_(cchMax
) LPWSTR
, _In_ LPCWSTR
, int cchMax
);
1516 #define StrCpyN WINELIB_NAME_AW(StrCpyN)
1517 #define StrNCpy WINELIB_NAME_AW(StrCpyN)
1519 INT WINAPI
StrCmpLogicalW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1521 INT WINAPI
StrCmpNA(_In_ LPCSTR
, _In_ LPCSTR
, INT
);
1522 INT WINAPI
StrCmpNW(_In_ LPCWSTR
, _In_ LPCWSTR
, INT
);
1523 #define StrCmpN WINELIB_NAME_AW(StrCmpN)
1524 #define StrNCmp WINELIB_NAME_AW(StrCmpN)
1526 INT WINAPI
StrCmpNIA(_In_ LPCSTR
, _In_ LPCSTR
, INT
);
1527 INT WINAPI
StrCmpNIW(_In_ LPCWSTR
, _In_ LPCWSTR
, INT
);
1528 #define StrCmpNI WINELIB_NAME_AW(StrCmpNI)
1529 #define StrNCmpI WINELIB_NAME_AW(StrCmpNI)
1531 LPSTR WINAPI
StrDupA(_In_ LPCSTR
);
1532 LPWSTR WINAPI
StrDupW(_In_ LPCWSTR
);
1533 #define StrDup WINELIB_NAME_AW(StrDup)
1535 HRESULT WINAPI
SHStrDupA(_In_ LPCSTR
, _Outptr_ WCHAR
**);
1536 HRESULT WINAPI
SHStrDupW(_In_ LPCWSTR
, _Outptr_ WCHAR
**);
1537 #define SHStrDup WINELIB_NAME_AW(SHStrDup)
1543 _Out_writes_(cchBuf
) LPSTR
,
1546 /* A/W Pairing is broken for this function */
1550 StrFormatByteSize64A(
1552 _Out_writes_(cchBuf
) LPSTR
,
1559 _Out_writes_(cchBuf
) LPWSTR
,
1562 #ifndef WINE_NO_UNICODE_MACROS
1564 #define StrFormatByteSize StrFormatByteSizeW
1566 #define StrFormatByteSize StrFormatByteSize64A
1574 _Out_writes_(cchBuf
) LPSTR
,
1581 _Out_writes_(cchBuf
) LPWSTR
,
1584 #define StrFormatKBSize WINELIB_NAME_AW(StrFormatKBSize)
1588 StrFromTimeIntervalA(
1589 _Out_writes_(cchMax
) LPSTR
,
1596 StrFromTimeIntervalW(
1597 _Out_writes_(cchMax
) LPWSTR
,
1602 #define StrFromTimeInterval WINELIB_NAME_AW(StrFromTimeInterval)
1604 BOOL WINAPI
StrIsIntlEqualA(BOOL
, _In_ LPCSTR
, _In_ LPCSTR
, int);
1605 BOOL WINAPI
StrIsIntlEqualW(BOOL
, _In_ LPCWSTR
, _In_ LPCWSTR
, int);
1606 #define StrIsIntlEqual WINELIB_NAME_AW(StrIsIntlEqual)
1608 #define StrIntlEqNA(a,b,c) StrIsIntlEqualA(TRUE,a,b,c)
1609 #define StrIntlEqNW(a,b,c) StrIsIntlEqualW(TRUE,a,b,c)
1611 #define StrIntlEqNIA(a,b,c) StrIsIntlEqualA(FALSE,a,b,c)
1612 #define StrIntlEqNIW(a,b,c) StrIsIntlEqualW(FALSE,a,b,c)
1614 LPSTR WINAPI
StrNCatA(_Inout_updates_(cchMax
) LPSTR
, LPCSTR
, int cchMax
);
1615 LPWSTR WINAPI
StrNCatW(_Inout_updates_(cchMax
) LPWSTR
, LPCWSTR
, int cchMax
);
1616 #define StrNCat WINELIB_NAME_AW(StrNCat)
1617 #define StrCatN WINELIB_NAME_AW(StrNCat)
1619 LPSTR WINAPI
StrPBrkA(_In_ LPCSTR
, _In_ LPCSTR
);
1620 LPWSTR WINAPI
StrPBrkW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1621 #define StrPBrk WINELIB_NAME_AW(StrPBrk)
1623 LPSTR WINAPI
StrRChrA(_In_ LPCSTR
, _In_opt_ LPCSTR
, WORD
);
1624 LPWSTR WINAPI
StrRChrW(_In_ LPCWSTR
, _In_opt_ LPCWSTR
, WCHAR
);
1625 #define StrRChr WINELIB_NAME_AW(StrRChr)
1627 LPSTR WINAPI
StrRChrIA(_In_ LPCSTR
, _In_opt_ LPCSTR
, WORD
);
1628 LPWSTR WINAPI
StrRChrIW(_In_ LPCWSTR
, _In_opt_ LPCWSTR
, WCHAR
);
1629 #define StrRChrI WINELIB_NAME_AW(StrRChrI)
1631 LPSTR WINAPI
StrRStrIA(_In_ LPCSTR
, _In_opt_ LPCSTR
, _In_ LPCSTR
);
1632 LPWSTR WINAPI
StrRStrIW(_In_ LPCWSTR
, _In_opt_ LPCWSTR
, _In_ LPCWSTR
);
1633 #define StrRStrI WINELIB_NAME_AW(StrRStrI)
1635 int WINAPI
StrSpnA(_In_ LPCSTR
, _In_ LPCSTR
);
1636 int WINAPI
StrSpnW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1637 #define StrSpn WINELIB_NAME_AW(StrSpn)
1639 LPSTR WINAPI
StrStrA(_In_ LPCSTR
, _In_ LPCSTR
);
1640 LPWSTR WINAPI
StrStrW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1641 #define StrStr WINELIB_NAME_AW(StrStr)
1643 LPSTR WINAPI
StrStrIA(_In_ LPCSTR
, _In_ LPCSTR
);
1644 LPWSTR WINAPI
StrStrIW(_In_ LPCWSTR
, _In_ LPCWSTR
);
1645 #define StrStrI WINELIB_NAME_AW(StrStrI)
1647 LPWSTR WINAPI
StrStrNW(_In_ LPCWSTR
, _In_ LPCWSTR
, UINT
);
1648 LPWSTR WINAPI
StrStrNIW(_In_ LPCWSTR
, _In_ LPCWSTR
, UINT
);
1650 int WINAPI
StrToIntA(_In_ LPCSTR
);
1651 int WINAPI
StrToIntW(_In_ LPCWSTR
);
1652 #define StrToInt WINELIB_NAME_AW(StrToInt)
1653 #define StrToLong WINELIB_NAME_AW(StrToInt)
1655 BOOL WINAPI
StrToIntExA(_In_ LPCSTR
, DWORD
, _Out_
int*);
1656 BOOL WINAPI
StrToIntExW(_In_ LPCWSTR
, DWORD
, _Out_
int*);
1657 #define StrToIntEx WINELIB_NAME_AW(StrToIntEx)
1659 BOOL WINAPI
StrToInt64ExA(_In_ LPCSTR
, DWORD
, _Out_ LONGLONG
*);
1660 BOOL WINAPI
StrToInt64ExW(_In_ LPCWSTR
, DWORD
, _Out_ LONGLONG
*);
1661 #define StrToIntEx64 WINELIB_NAME_AW(StrToIntEx64)
1663 BOOL WINAPI
StrTrimA(_Inout_ LPSTR
, _In_ LPCSTR
);
1664 BOOL WINAPI
StrTrimW(_Inout_ LPWSTR
, _In_ LPCWSTR
);
1665 #define StrTrim WINELIB_NAME_AW(StrTrim)
1670 _Out_writes_(cchDest
) LPSTR
,
1672 _In_ _Printf_format_string_ LPCSTR
,
1678 _Out_writes_(cchDest
) LPWSTR
,
1680 _In_ _Printf_format_string_ LPCWSTR
,
1683 #define wvnsprintf WINELIB_NAME_AW(wvnsprintf)
1688 _Out_writes_(cchDest
) LPSTR
,
1690 _In_ _Printf_format_string_ LPCSTR
,
1696 _Out_writes_(cchDest
) LPWSTR
,
1698 _In_ _Printf_format_string_ LPCWSTR
,
1701 #define wnsprintf WINELIB_NAME_AW(wnsprintf)
1705 SHLoadIndirectString(
1707 _Out_writes_(cchOutBuf
) LPWSTR
,
1708 _In_ UINT cchOutBuf
,
1715 _In_reads_(nChar
) LPCSTR
,
1716 _In_reads_(nChar
) LPCSTR
,
1723 _In_reads_(nChar
) LPCWSTR
,
1724 _In_reads_(nChar
) LPCWSTR
,
1727 #define IntlStrEqWorker WINELIB_NAME_AW(IntlStrEqWorker)
1729 #define IntlStrEqNA(s1,s2,n) IntlStrEqWorkerA(TRUE,s1,s2,n)
1730 #define IntlStrEqNW(s1,s2,n) IntlStrEqWorkerW(TRUE,s1,s2,n)
1731 #define IntlStrEqN WINELIB_NAME_AW(IntlStrEqN)
1733 #define IntlStrEqNIA(s1,s2,n) IntlStrEqWorkerA(FALSE,s1,s2,n)
1734 #define IntlStrEqNIW(s1,s2,n) IntlStrEqWorkerW(FALSE,s1,s2,n)
1735 #define IntlStrEqNI WINELIB_NAME_AW(IntlStrEqNI)
1741 _In_opt_ LPCITEMIDLIST
,
1748 _In_opt_ LPCITEMIDLIST
,
1751 #define StrRetToStr WINELIB_NAME_AW(StrRetToStr)
1757 _In_opt_ LPCITEMIDLIST
,
1758 _Out_writes_(cchBuf
) LPSTR
,
1765 _In_opt_ LPCITEMIDLIST
,
1766 _Out_writes_(cchBuf
) LPWSTR
,
1769 #define StrRetToBuf WINELIB_NAME_AW(StrRetToBuf)
1775 _In_opt_ LPCITEMIDLIST
,
1778 BOOL WINAPI
IsCharSpaceA(CHAR
);
1779 BOOL WINAPI
IsCharSpaceW(WCHAR
);
1780 #define IsCharSpace WINELIB_NAME_AW(IsCharSpace)
1782 #endif /* NO_SHLWAPI_STRFCNS */
1786 #ifndef NO_SHLWAPI_GDI
1788 HPALETTE WINAPI
SHCreateShellPalette(_In_opt_ HDC
);
1790 COLORREF WINAPI
ColorHLSToRGB(WORD
,WORD
,WORD
);
1792 COLORREF WINAPI
ColorAdjustLuma(COLORREF
,int,BOOL
);
1794 VOID WINAPI
ColorRGBToHLS(COLORREF
, _Out_ LPWORD
, _Out_ LPWORD
, _Out_ LPWORD
);
1796 #endif /* NO_SHLWAPI_GDI */
1798 /* Security functions */
1799 BOOL WINAPI
IsInternetESCEnabled(void);
1801 /* Stream functions */
1802 #ifndef NO_SHLWAPI_STREAM
1820 #define SHOpenRegStream WINELIB_NAME_AW(SHOpenRegStream2) /* Uses version 2 */
1838 #define SHOpenRegStream2 WINELIB_NAME_AW(SHOpenRegStream2)
1842 SHCreateStreamOnFileA(
1845 _Outptr_
struct IStream
**);
1849 SHCreateStreamOnFileW(
1852 _Outptr_
struct IStream
**);
1854 #define SHCreateStreamOnFile WINELIB_NAME_AW(SHCreateStreamOnFile)
1859 _In_reads_bytes_opt_(cbInit
) const BYTE
*pInit
,
1864 SHCreateStreamOnFileEx(
1869 _In_opt_
struct IStream
*,
1870 _Outptr_
struct IStream
**);
1872 HRESULT WINAPI
SHCreateStreamWrapper(LPBYTE
,DWORD
,DWORD
,struct IStream
**);
1874 #endif /* NO_SHLWAPI_STREAM */
1876 #ifndef NO_SHLWAPI_SHARED
1878 // These functions are only included in this file starting with the Windows 7 platform SDK
1883 _In_opt_
const void *pvData
,
1885 _In_ DWORD dwDestinationProcessId
1892 _In_ DWORD dwProcessId
1905 _In_ DWORD dwProcessId
1908 #endif /* NO_SHLWAPI_SHARED */
1910 /* SHAutoComplete flags */
1911 #define SHACF_DEFAULT 0x00000000
1912 #define SHACF_FILESYSTEM 0x00000001
1913 #define SHACF_URLHISTORY 0x00000002
1914 #define SHACF_URLMRU 0x00000004
1915 #define SHACF_URLALL (SHACF_URLHISTORY|SHACF_URLMRU)
1916 #define SHACF_USETAB 0x00000008
1917 #define SHACF_FILESYS_ONLY 0x00000010
1918 #define SHACF_FILESYS_DIRS 0x00000020
1919 #define SHACF_AUTOSUGGEST_FORCE_ON 0x10000000
1920 #define SHACF_AUTOSUGGEST_FORCE_OFF 0x20000000
1921 #define SHACF_AUTOAPPEND_FORCE_ON 0x40000000
1922 #define SHACF_AUTOAPPEND_FORCE_OFF 0x80000000
1924 HRESULT WINAPI
SHAutoComplete(_In_ HWND
, DWORD
);
1927 HRESULT WINAPI
SHCreateThreadRef(_Inout_ LONG
*, _Outptr_ IUnknown
**);
1928 HRESULT WINAPI
SHGetThreadRef(_Outptr_ IUnknown
**);
1929 HRESULT WINAPI
SHSetThreadRef(_In_opt_ IUnknown
*);
1930 HRESULT WINAPI
SHReleaseThreadRef(void);
1932 /* SHCreateThread flags */
1933 #define CTF_INSIST 0x01 /* Always call */
1934 #define CTF_THREAD_REF 0x02 /* Hold thread ref */
1935 #define CTF_PROCESS_REF 0x04 /* Hold process ref */
1936 #define CTF_COINIT 0x08 /* Startup COM first */
1937 #define CTF_FREELIBANDEXIT 0x10 /* Hold DLL ref */
1938 #define CTF_REF_COUNTED 0x20 /* Thread is ref counted */
1939 #define CTF_WAIT_ALLOWCOM 0x40 /* Allow marshalling */
1944 _In_ LPTHREAD_START_ROUTINE
,
1947 _In_opt_ LPTHREAD_START_ROUTINE
);
1949 BOOL WINAPI
SHSkipJunction(_In_opt_
struct IBindCtx
*, _In_
const CLSID
*);
1951 /* Version Information */
1953 typedef struct _DllVersionInfo
{
1955 DWORD dwMajorVersion
;
1956 DWORD dwMinorVersion
;
1957 DWORD dwBuildNumber
;
1961 #define DLLVER_PLATFORM_WINDOWS 0x01 /* Win9x */
1962 #define DLLVER_PLATFORM_NT 0x02 /* WinNT */
1964 typedef HRESULT (CALLBACK
*DLLGETVERSIONPROC
)(DLLVERSIONINFO
*);
1967 /* shouldn't be here, but is nice for type checking */
1968 HRESULT WINAPI
DllGetVersion(DLLVERSIONINFO
*) DECLSPEC_HIDDEN
;
1971 typedef struct _DLLVERSIONINFO2
{
1972 DLLVERSIONINFO info1
;
1973 DWORD dwFlags
; /* Reserved */
1974 ULONGLONG
DECLSPEC_ALIGN(8) ullVersion
; /* 16 bits each for Major, Minor, Build, QFE */
1977 #define DLLVER_MAJOR_MASK 0xFFFF000000000000
1978 #define DLLVER_MINOR_MASK 0x0000FFFF00000000
1979 #define DLLVER_BUILD_MASK 0x00000000FFFF0000
1980 #define DLLVER_QFE_MASK 0x000000000000FFFF
1982 #define MAKEDLLVERULL(mjr, mnr, bld, qfe) (((ULONGLONG)(mjr)<< 48)| \
1983 ((ULONGLONG)(mnr)<< 32) | ((ULONGLONG)(bld)<< 16) | (ULONGLONG)(qfe))
1985 HRESULT WINAPI
DllInstall(BOOL
, _In_opt_ LPCWSTR
) DECLSPEC_HIDDEN
;
1988 #if (_WIN32_IE >= 0x0600)
1989 #define SHGVSPB_PERUSER 0x00000001
1990 #define SHGVSPB_ALLUSERS 0x00000002
1991 #define SHGVSPB_PERFOLDER 0x00000004
1992 #define SHGVSPB_ALLFOLDERS 0x00000008
1993 #define SHGVSPB_INHERIT 0x00000010
1994 #define SHGVSPB_ROAM 0x00000020
1995 #define SHGVSPB_NOAUTODEFAULTS 0x80000000
1997 #define SHGVSPB_FOLDER (SHGVSPB_PERUSER | SHGVSPB_PERFOLDER)
1998 #define SHGVSPB_FOLDERNODEFAULTS (SHGVSPB_PERUSER | SHGVSPB_PERFOLDER | SHGVSPB_NOAUTODEFAULTS)
1999 #define SHGVSPB_USERDEFAULTS (SHGVSPB_PERUSER | SHGVSPB_ALLFOLDERS)
2000 #define SHGVSPB_GLOBALDEAFAULTS (SHGVSPB_ALLUSERS | SHGVSPB_ALLFOLDERS)
2004 SHGetViewStatePropertyBag(
2005 _In_opt_ LPCITEMIDLIST pidl
,
2006 _In_opt_ LPWSTR bag_name
,
2009 _Outptr_
void **ppv
);
2011 #endif /* (_WIN32_IE >= 0x0600) */
2014 /* IsOS definitions */
2016 #define OS_WIN32SORGREATER 0x00
2018 #define OS_WIN95ORGREATER 0x02
2019 #define OS_NT4ORGREATER 0x03
2020 #define OS_WIN2000ORGREATER_ALT 0x04
2021 #define OS_WIN98ORGREATER 0x05
2022 #define OS_WIN98_GOLD 0x06
2023 #define OS_WIN2000ORGREATER 0x07
2024 #define OS_WIN2000PRO 0x08
2025 #define OS_WIN2000SERVER 0x09
2026 #define OS_WIN2000ADVSERVER 0x0A
2027 #define OS_WIN2000DATACENTER 0x0B
2028 #define OS_WIN2000TERMINAL 0x0C
2029 #define OS_EMBEDDED 0x0D
2030 #define OS_TERMINALCLIENT 0x0E
2031 #define OS_TERMINALREMOTEADMIN 0x0F
2032 #define OS_WIN95_GOLD 0x10
2033 #define OS_MEORGREATER 0x11
2034 #define OS_XPORGREATER 0x12
2035 #define OS_HOME 0x13
2036 #define OS_PROFESSIONAL 0x14
2037 #define OS_DATACENTER 0x15
2038 #define OS_ADVSERVER 0x16
2039 #define OS_SERVER 0x17
2040 #define OS_TERMINALSERVER 0x18
2041 #define OS_PERSONALTERMINALSERVER 0x19
2042 #define OS_FASTUSERSWITCHING 0x1A
2043 #define OS_WELCOMELOGONUI 0x1B
2044 #define OS_DOMAINMEMBER 0x1C
2045 #define OS_ANYSERVER 0x1D
2046 #define OS_WOW6432 0x1E
2047 #define OS_WEBSERVER 0x1F
2048 #define OS_SMALLBUSINESSSERVER 0x20
2049 #define OS_TABLETPC 0x21
2050 #define OS_SERVERADMINUI 0x22
2051 #define OS_MEDIACENTER 0x23
2052 #define OS_APPLIANCE 0x24
2054 BOOL WINAPI
IsOS(DWORD
);
2056 /* SHSetTimerQueueTimer definitions */
2057 #define TPS_EXECUTEIO 0x00000001
2058 #define TPS_LONGEXECTIME 0x00000008
2060 /* SHFormatDateTimeA/SHFormatDateTimeW flags */
2061 #define FDTF_SHORTTIME 0x00000001
2062 #define FDTF_SHORTDATE 0x00000002
2063 #define FDTF_DEFAULT (FDTF_SHORTDATE | FDTF_SHORTTIME)
2064 #define FDTF_LONGDATE 0x00000004
2065 #define FDTF_LONGTIME 0x00000008
2066 #define FDTF_RELATIVE 0x00000010
2067 #define FDTF_LTRDATE 0x00000100
2068 #define FDTF_RTLDATE 0x00000200
2069 #define FDTF_NOAUTOREADINGORDER 0x00000400
2082 _In_
const QITAB
*pqit
,
2084 _Outptr_
void **ppv
);
2086 #define OFFSETOFCLASS(base, derived) \
2087 ((DWORD)(DWORD_PTR)(static_cast<base*>((derived*)8))-8)
2089 #include <poppack.h>
2093 #endif /* defined(__cplusplus) */
2095 #endif /* __WINE_SHLWAPI_H */