shlwapi_undoc.h

Go to the documentation of this file.

/*
 * PROJECT:     ReactOS header
 * LICENSE:     LGPL-2.1-or-later (https://spdx.org/licenses/LGPL-2.1-or-later)
 * PURPOSE:     Undocumented SHLWAPI definitions
 * COPYRIGHT:   Copyright 2009 Andrew Hill <ash77 at domain reactos.org>
 *              Copyright 2026 Katayama Hirofumi MZ <katayama.hirofumi.mz@gmail.com>
 */
 
#pragma once
 
#include <winreg.h> // For REGSAM
 
#if !defined(_INC_SHLWAPI) && !defined(__WINE_SHLWAPI_H)
#error Please #include <shlwapi.h> first
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define SHELL_NO_POLICY ((DWORD)-1)
 
typedef struct tagPOLICYDATA
{
    DWORD policy;    /* flags value passed to SHRestricted */
    LPCWSTR appstr;  /* application str such as "Explorer" */
    LPCWSTR keystr;  /* name of the actual registry key / policy */
} POLICYDATA, *LPPOLICYDATA;
 
HANDLE WINAPI SHGlobalCounterCreate(REFGUID guid);
PVOID WINAPI SHInterlockedCompareExchange(PVOID *dest, PVOID xchg, PVOID compare);
LONG WINAPI SHGlobalCounterGetValue(HANDLE hGlobalCounter);
LONG WINAPI SHGlobalCounterIncrement(HANDLE hGlobalCounter);
 
#if FALSE && ((DLL_EXPORT_VERSION) >= _WIN32_WINNT_VISTA)
#define SHELL_GCOUNTER_DEFINE_GUID(name, a, b, c, d, e, f, g, h, i, j, k) enum { SHELLUNUSEDCOUNTERGUID_##name }
#define SHELL_GCOUNTER_DEFINE_HANDLE(name) enum { SHELLUNUSEDCOUNTERHANDLE_##name }
#define SHELL_GCOUNTER_PARAMETERS(handle, id) id
#define SHELL_GlobalCounterCreate(refguid, handle) ( (refguid), (handle), (void)0 )
#define SHELL_GlobalCounterIsInitialized(handle) ( (handle), TRUE )
#define SHELL_GlobalCounterGet(id) SHGlobalCounterGetValue_Vista(id)
#define SHELL_GlobalCounterIncrement(id) SHGlobalCounterIncrement_Vista(id)
#else
#define SHELL_GCOUNTER_DEFINE_GUID(name, a, b, c, d, e, f, g, h, i, j, k) const GUID name = { a, b, c, { d, e, f, g, h, i, j, k } }
#define SHELL_GCOUNTER_DEFINE_HANDLE(name) HANDLE name = NULL
#define SHELL_GCOUNTER_PARAMETERS(handle, id) handle
#define SHELL_GlobalCounterCreate(refguid, handle) \
  do { \
    EXTERN_C HANDLE SHELL_GetCachedGlobalCounter(HANDLE *phGlobalCounter, REFGUID rguid); \
    SHELL_GetCachedGlobalCounter(&(handle), (refguid)); \
  } while (0)
#define SHELL_GlobalCounterIsInitialized(handle) ( (handle) != NULL )
#define SHELL_GlobalCounterGet(handle) SHGlobalCounterGetValue(handle)
#define SHELL_GlobalCounterIncrement(handle) SHGlobalCounterIncrement(handle)
#endif
#define SHELL_GCOUNTER_DECLAREPARAMETERS(handle, id) SHELL_GCOUNTER_PARAMETERS(HANDLE handle, SHGLOBALCOUNTER id)
 
DWORD WINAPI
SHRestrictionLookup(
    _In_ DWORD policy,
    _In_ LPCWSTR key,
    _In_ const POLICYDATA *polTable,
    _Inout_ LPDWORD polArr);
 
INT WINAPI SHRestrictedMessageBox(_In_ HWND hWnd);
 
BOOL WINAPI SHAboutInfoA(LPSTR lpszDest, DWORD dwDestLen);
BOOL WINAPI SHAboutInfoW(LPWSTR lpszDest, DWORD dwDestLen);
 
PSTR WINAPI
NextPathA(
    _In_ PCSTR pszStart,
    _Out_writes_(cchDest) PSTR pszDest,
    _In_ UINT cchDest);
 
PWSTR WINAPI
NextPathW(
    _In_ PCWSTR pszStart,
    _Out_writes_(cchDest) PWSTR pszDest,
    _In_ UINT cchDest);
 
#ifdef UNICODE
#define SHAboutInfo SHAboutInfoW
#define NextPath NextPathW
#else
#define SHAboutInfo SHAboutInfoA
#define NextPath NextPathA
#endif
 
HRESULT WINAPI
IUnknown_ShowBrowserBar(
    _In_ IUnknown* punk,
    _In_ REFGUID rguid,
    _In_ BOOL bShow);
 
HRESULT WINAPI CLSIDFromStringWrap(_In_ LPCWSTR idstr, _Out_ CLSID *id);
HMODULE WINAPI SHPinDllOfCLSID(REFIID refiid);
HRESULT WINAPI IUnknown_QueryStatus(IUnknown *lpUnknown, REFGUID pguidCmdGroup, ULONG cCmds, OLECMD *prgCmds, OLECMDTEXT* pCmdText);
HRESULT WINAPI IUnknown_Exec(IUnknown* lpUnknown, REFGUID pguidCmdGroup, DWORD nCmdID, DWORD nCmdexecopt, VARIANT* pvaIn, VARIANT* pvaOut);
LONG WINAPI SHSetWindowBits(HWND hwnd, INT offset, UINT wMask, UINT wFlags);
HWND WINAPI SHSetParentHwnd(HWND hWnd, HWND hWndParent);
HRESULT WINAPI ConnectToConnectionPoint(IUnknown *lpUnkSink, REFIID riid, BOOL bAdviseOnly, IUnknown *lpUnknown, LPDWORD lpCookie, IConnectionPoint **lppCP);
BOOL WINAPI SHIsSameObject(IUnknown *lpInt1, IUnknown *lpInt2);
BOOL WINAPI SHLoadMenuPopup(HINSTANCE hInst, LPCWSTR szName);
void WINAPI SHPropagateMessage(HWND hWnd, UINT uiMsgId, WPARAM wParam, LPARAM lParam, BOOL bSend);
DWORD WINAPI SHRemoveAllSubMenus(HMENU hMenu);
UINT WINAPI SHEnableMenuItem(HMENU hMenu, UINT wItemID, BOOL bEnable);
DWORD WINAPI SHCheckMenuItem(HMENU hMenu, UINT uID, BOOL bCheck);
DWORD WINAPI SHRegisterClassA(WNDCLASSA *wndclass);
BOOL WINAPI SHSimulateDrop(IDropTarget *pDrop, IDataObject *pDataObj, DWORD grfKeyState, PPOINTL lpPt, DWORD* pdwEffect);
DWORD WINAPI SHGetCurColorRes(void);
HMENU WINAPI SHGetMenuFromID(HMENU hMenu, UINT uID);
DWORD WINAPI SHMenuIndexFromID(HMENU hMenu, UINT uID);
DWORD WINAPI SHWaitForSendMessageThread(HANDLE hand, DWORD dwTimeout);
DWORD WINAPI SHSendMessageBroadcastW(UINT uMsg, WPARAM wParam, LPARAM lParam);
HRESULT WINAPI SHIsExpandableFolder(LPSHELLFOLDER lpFolder, LPCITEMIDLIST pidl);
DWORD WINAPI SHFillRectClr(HDC hDC, LPCRECT pRect, COLORREF cRef);
int WINAPI SHSearchMapInt(const int *lpKeys, const int *lpValues, int iLen, int iKey);
 
HRESULT WINAPI
SHInvokeCommandsOnContextMenu(
    _In_opt_ HWND hwnd,
    _In_opt_ IUnknown *punkSite,
    _In_ IContextMenu *pCM,
    _In_ DWORD fMask,
    _In_reads_opt_(cVerbs) PCSTR *pVerbs,
    _In_ UINT cVerbs);
 
HRESULT WINAPI
MayQSForward(
    _In_ IUnknown *lpUnknown,
    _In_ INT nUnknown,
    _In_opt_ REFGUID riidCmdGrp,
    _In_ ULONG cCmds,
    _Inout_ OLECMD *prgCmds,
    _Inout_ OLECMDTEXT *pCmdText);
 
HRESULT WINAPI
MayExecForward(
    _In_ IUnknown *lpUnknown,
    _In_ INT nUnknown,
    _In_opt_ REFGUID pguidCmdGroup,
    _In_ DWORD nCmdID,
    _In_ DWORD nCmdexecopt,
    _In_ VARIANT *pvaIn,
    _Inout_ VARIANT *pvaOut);
 
HRESULT WINAPI IsQSForward(_In_opt_ REFGUID pguidCmdGroup, _In_ ULONG cCmds, _In_ OLECMD *prgCmds);
BOOL WINAPI SHIsChildOrSelf(HWND hParent, HWND hChild);
HRESULT WINAPI SHForwardContextMenuMsg(IUnknown* pUnk, UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT* pResult, BOOL useIContextMenu2);
VOID WINAPI SHSetDefaultDialogFont(HWND hWnd, INT id);
EXTERN_C BOOL WINAPI SHBoolSystemParametersInfo(UINT uiAction, PVOID pvParam);
 
HRESULT WINAPI SHRegGetCLSIDKeyW(REFGUID guid, LPCWSTR lpszValue, BOOL bUseHKCU, BOOL bCreate, PHKEY phKey);
 
HRESULT WINAPI
QuerySourceCreateFromKey(
    _In_ HKEY hKey,
    _In_opt_ PCWSTR lpSubKey,
    _In_ BOOL bCreate,
    _In_ REFIID riid,
    _Outptr_ PVOID *ppv);
 
BOOL WINAPI SHAddDataBlock(LPDBLIST* lppList, const DATABLOCK_HEADER *lpNewItem);
BOOL WINAPI SHRemoveDataBlock(LPDBLIST* lppList, DWORD dwSignature);
DATABLOCK_HEADER* WINAPI SHFindDataBlock(LPDBLIST lpList, DWORD dwSignature);
HRESULT WINAPI SHWriteDataBlockList(IStream* lpStream, LPDBLIST lpList);
HRESULT WINAPI SHReadDataBlockList(IStream* lpStream, LPDBLIST* lppList);
VOID WINAPI SHFreeDataBlockList(LPDBLIST lpList);
 
HRESULT WINAPI IStream_ReadPidl(_In_ IStream *pstm, _Out_ LPITEMIDLIST *ppidlOut);
HRESULT WINAPI IStream_WritePidl(_In_ IStream *pstm, _In_ LPCITEMIDLIST pidlWrite);
 
LONG
WINAPI
RegCreateKeyExWrapW(
    _In_ HKEY hKey,
    _In_ LPCWSTR lpSubKey,
    _In_ DWORD Reserved,
    _In_opt_ LPWSTR lpClass,
    _In_ DWORD dwOptions,
    _In_ REGSAM samDesired,
    _In_opt_ LPSECURITY_ATTRIBUTES lpSecurityAttributes,
    _Out_ PHKEY phkResult,
    _Out_opt_ LPDWORD lpdwDisposition);
 
/* Redirected to kernel32.ExpandEnvironmentStringsA/W */
DWORD WINAPI SHExpandEnvironmentStringsA(LPCSTR,LPSTR,DWORD);
DWORD WINAPI SHExpandEnvironmentStringsW(LPCWSTR,LPWSTR,DWORD);
#ifdef UNICODE
#define SHExpandEnvironmentStrings SHExpandEnvironmentStringsW
#else
#define SHExpandEnvironmentStrings SHExpandEnvironmentStringsA
#endif
 
/* Redirected to userenv.ExpandEnvironmentStringsForUserA/W */
#if (WINVER >= 0x0500)
BOOL WINAPI SHExpandEnvironmentStringsForUserA(HANDLE, LPCSTR, LPSTR, DWORD);
BOOL WINAPI SHExpandEnvironmentStringsForUserW(HANDLE, LPCWSTR, LPWSTR, DWORD);
#ifdef UNICODE
#define SHExpandEnvironmentStringsForUser SHExpandEnvironmentStringsForUserW
#else
#define SHExpandEnvironmentStringsForUser SHExpandEnvironmentStringsForUserA
#endif
#endif
 
 
BOOL WINAPI SHIsEmptyStream(IStream*);
HRESULT WINAPI SHInvokeDefaultCommand(HWND,IShellFolder*,LPCITEMIDLIST);
HRESULT WINAPI SHPropertyBag_ReadType(IPropertyBag *ppb, LPCWSTR pszPropName, VARIANTARG *pvarg, VARTYPE vt);
HRESULT WINAPI SHPropertyBag_ReadBOOL(IPropertyBag *ppb, LPCWSTR pszPropName, BOOL *pbValue);
BOOL WINAPI SHPropertyBag_ReadBOOLOld(IPropertyBag *ppb, LPCWSTR pszPropName, BOOL bDefValue);
HRESULT WINAPI SHPropertyBag_ReadSHORT(IPropertyBag *ppb, LPCWSTR pszPropName, SHORT *psValue);
HRESULT WINAPI SHPropertyBag_ReadInt(IPropertyBag *ppb, LPCWSTR pszPropName, LPINT pnValue);
HRESULT WINAPI SHPropertyBag_ReadLONG(IPropertyBag *ppb, LPCWSTR pszPropName, LPLONG pValue);
HRESULT WINAPI SHPropertyBag_ReadDWORD(IPropertyBag *ppb, LPCWSTR pszPropName, DWORD *pdwValue);
HRESULT WINAPI SHPropertyBag_ReadBSTR(IPropertyBag *ppb, LPCWSTR pszPropName, BSTR *pbstr);
HRESULT WINAPI SHPropertyBag_ReadStr(IPropertyBag *ppb, LPCWSTR pszPropName, LPWSTR pszDst, int cchMax);
HRESULT WINAPI SHPropertyBag_ReadPOINTL(IPropertyBag *ppb, LPCWSTR pszPropName, POINTL *pptl);
HRESULT WINAPI SHPropertyBag_ReadPOINTS(IPropertyBag *ppb, LPCWSTR pszPropName, POINTS *ppts);
HRESULT WINAPI SHPropertyBag_ReadRECTL(IPropertyBag *ppb, LPCWSTR pszPropName, RECTL *prcl);
HRESULT WINAPI SHPropertyBag_ReadGUID(IPropertyBag *ppb, LPCWSTR pszPropName, GUID *pguid);
HRESULT WINAPI SHPropertyBag_ReadStream(IPropertyBag *ppb, LPCWSTR pszPropName, IStream **ppStream);
 
INT WINAPI
SHGetPerScreenResName(
    _Out_writes_(cchBuffer) LPWSTR pszBuffer,
    _In_ INT cchBuffer,
    _In_ DWORD dwReserved);
 
HRESULT WINAPI SHPropertyBag_Delete(IPropertyBag *ppb, LPCWSTR pszPropName);
HRESULT WINAPI SHPropertyBag_WriteBOOL(IPropertyBag *ppb, LPCWSTR pszPropName, BOOL bValue);
HRESULT WINAPI SHPropertyBag_WriteSHORT(IPropertyBag *ppb, LPCWSTR pszPropName, SHORT sValue);
HRESULT WINAPI SHPropertyBag_WriteInt(IPropertyBag *ppb, LPCWSTR pszPropName, INT nValue);
HRESULT WINAPI SHPropertyBag_WriteLONG(IPropertyBag *ppb, LPCWSTR pszPropName, LONG lValue);
HRESULT WINAPI SHPropertyBag_WriteDWORD(IPropertyBag *ppb, LPCWSTR pszPropName, DWORD dwValue);
HRESULT WINAPI SHPropertyBag_WriteStr(IPropertyBag *ppb, LPCWSTR pszPropName, LPCWSTR pszValue);
HRESULT WINAPI SHPropertyBag_WriteGUID(IPropertyBag *ppb, LPCWSTR pszPropName, const GUID *pguid);
HRESULT WINAPI SHPropertyBag_WriteStream(IPropertyBag *ppb, LPCWSTR pszPropName, IStream *pStream);
HRESULT WINAPI SHPropertyBag_WritePOINTL(IPropertyBag *ppb, LPCWSTR pszPropName, const POINTL *pptl);
HRESULT WINAPI SHPropertyBag_WritePOINTS(IPropertyBag *ppb, LPCWSTR pszPropName, const POINTS *ppts);
HRESULT WINAPI SHPropertyBag_WriteRECTL(IPropertyBag *ppb, LPCWSTR pszPropName, const RECTL *prcl);
 
HRESULT WINAPI SHCreatePropertyBagOnMemory(_In_ DWORD dwMode, _In_ REFIID riid, _Out_ void **ppvObj);
 
HRESULT WINAPI
SHCreatePropertyBagOnRegKey(
    _In_ HKEY hKey,
    _In_z_ LPCWSTR pszSubKey,
    _In_ DWORD dwMode,
    _In_ REFIID riid,
    _Out_ void **ppvObj);
 
HRESULT WINAPI
SHCreatePropertyBagOnProfileSection(
    _In_z_ LPCWSTR lpFileName,
    _In_opt_z_ LPCWSTR pszSection,
    _In_ DWORD dwMode,
    _In_ REFIID riid,
    _Out_ void **ppvObj);
 
EXTERN_C HRESULT WINAPI
IUnknown_QueryServicePropertyBag(
    _In_ IUnknown *punk,
    _In_ long flags,
    _In_ REFIID riid,
    _Outptr_ void **ppvObj);
 
HWND WINAPI SHCreateWorkerWindowA(WNDPROC wndProc, HWND hWndParent, DWORD dwExStyle,
                                  DWORD dwStyle, HMENU hMenu, LONG_PTR wnd_extra);
 
HWND WINAPI SHCreateWorkerWindowW(WNDPROC wndProc, HWND hWndParent, DWORD dwExStyle,
                                  DWORD dwStyle, HMENU hMenu, LONG_PTR wnd_extra);
#ifdef UNICODE
#define SHCreateWorkerWindow SHCreateWorkerWindowW
#else
#define SHCreateWorkerWindow SHCreateWorkerWindowA
#endif
 
HRESULT WINAPI IUnknown_SetOwner(IUnknown *iface, IUnknown *pUnk);
HRESULT WINAPI IUnknown_GetClassID(IUnknown *lpUnknown, CLSID *lpClassId);
HRESULT WINAPI IUnknown_QueryServiceExec(IUnknown *lpUnknown, REFIID service, const GUID *group, DWORD cmdId, DWORD cmdOpt, VARIANT *pIn, VARIANT *pOut);
HRESULT WINAPI IUnknown_UIActivateIO(IUnknown *unknown, BOOL activate, LPMSG msg);
HRESULT WINAPI IUnknown_TranslateAcceleratorOCS(IUnknown *lpUnknown, LPMSG lpMsg, DWORD dwModifiers);
HRESULT WINAPI IUnknown_OnFocusOCS(IUnknown *lpUnknown, BOOL fGotFocus);
HRESULT WINAPI IUnknown_HandleIRestrict(LPUNKNOWN lpUnknown, PVOID lpArg1, PVOID lpArg2, PVOID lpArg3, PVOID lpArg4);
HRESULT WINAPI IUnknown_HasFocusIO(IUnknown * punk);
HRESULT WINAPI IUnknown_TranslateAcceleratorIO(IUnknown * punk, MSG * pmsg);
HRESULT WINAPI IUnknown_OnFocusChangeIS(LPUNKNOWN lpUnknown, LPUNKNOWN pFocusObject, BOOL bFocus);
 
DWORD WINAPI SHAnsiToUnicode(LPCSTR lpSrcStr, LPWSTR lpDstStr, INT iLen);
INT WINAPI SHUnicodeToAnsi(LPCWSTR lpSrcStr, LPSTR lpDstStr, INT iLen);
 
DWORD WINAPI SHAnsiToUnicodeCP(DWORD dwCp, LPCSTR lpSrcStr, LPWSTR lpDstStr, int iLen);
DWORD WINAPI SHUnicodeToAnsiCP(UINT CodePage, LPCWSTR lpSrcStr, LPSTR lpDstStr, int dstlen);
 
PVOID WINAPI SHLockSharedEx(HANDLE hData, DWORD dwProcessId, BOOL bWriteAccess);
 
DWORD WINAPI SHGetValueGoodBootA(HKEY hkey, LPCSTR pSubKey, LPCSTR pValue,
                                 LPDWORD pwType, LPVOID pvData, LPDWORD pbData);
DWORD WINAPI SHGetValueGoodBootW(HKEY hkey, LPCWSTR pSubKey, LPCWSTR pValue,
                                 LPDWORD pwType, LPVOID pvData, LPDWORD pbData);
HRESULT WINAPI SHLoadRegUIStringA(HKEY hkey, LPCSTR value, LPSTR buf, DWORD size);
HRESULT WINAPI SHLoadRegUIStringW(HKEY hkey, LPCWSTR value, LPWSTR buf, DWORD size);
#ifdef UNICODE
#define SHGetValueGoodBoot SHGetValueGoodBootW
#define SHLoadRegUIString  SHLoadRegUIStringW
#else
#define SHGetValueGoodBoot SHGetValueGoodBootA
#define SHLoadRegUIString  SHLoadRegUIStringA
#endif
 
DWORD WINAPI
SHGetIniStringW(
    _In_z_ LPCWSTR appName,
    _In_z_ LPCWSTR keyName,
    _Out_writes_to_(outLen, return + 1) LPWSTR out,
    _In_ DWORD outLen,
    _In_z_ LPCWSTR filename);
 
BOOL WINAPI
SHSetIniStringW(
    _In_z_ LPCWSTR appName,
    _In_z_ LPCWSTR keyName,
    _In_opt_z_ LPCWSTR str,
    _In_z_ LPCWSTR filename);
 
DWORD WINAPI
SHGetIniStringUTF7W(
    _In_opt_z_ LPCWSTR lpAppName,
    _In_z_ LPCWSTR lpKeyName,
    _Out_writes_to_(nSize, return + 1) _Post_z_ LPWSTR lpReturnedString,
    _In_ DWORD nSize,
    _In_z_ LPCWSTR lpFileName);
 
BOOL WINAPI
SHSetIniStringUTF7W(
    _In_z_ LPCWSTR lpAppName,
    _In_z_ LPCWSTR lpKeyName,
    _In_opt_z_ LPCWSTR lpString,
    _In_z_ LPCWSTR lpFileName);
 
enum _shellkey_flags
{
    SHKEY_Root_HKCU = 0x1,
    SHKEY_Root_HKLM = 0x2,
    SHKEY_Key_Explorer = 0x00,
    SHKEY_Key_Shell = 0x10,
    SHKEY_Key_ShellNoRoam = 0x20,
    SHKEY_Key_Classes = 0x30,
    SHKEY_Subkey_Default = 0x0000,
    SHKEY_Subkey_ResourceName = 0x1000,
    SHKEY_Subkey_Handlers = 0x2000,
    SHKEY_Subkey_Associations = 0x3000,
    SHKEY_Subkey_Volatile = 0x4000,
    SHKEY_Subkey_MUICache = 0x5000,
    SHKEY_Subkey_FileExts = 0x6000
};
 
HKEY WINAPI SHGetShellKey(DWORD flags, LPCWSTR sub_key, BOOL create);
HRESULT WINAPI SKGetValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value, DWORD *type,
                           void *data, DWORD *count);
HRESULT WINAPI SKSetValueW(DWORD flags, LPCWSTR subkey, LPCWSTR value,
                           DWORD type, void *data, DWORD count);
 
int
WINAPIV
ShellMessageBoxWrapW(
  _In_opt_ HINSTANCE hAppInst,
  _In_opt_ HWND hWnd,
  _In_ LPCWSTR lpcText,
  _In_opt_ LPCWSTR lpcTitle,
  _In_ UINT fuStyle,
  ...);
 
/* dwWhich flags for PathFileExistsDefExtW, PathFindOnPathExW,
 * and PathFileExistsDefExtAndAttributesW */
#define WHICH_PIF       (1 << 0)
#define WHICH_COM       (1 << 1)
#define WHICH_EXE       (1 << 2)
#define WHICH_BAT       (1 << 3)
#define WHICH_LNK       (1 << 4)
#define WHICH_CMD       (1 << 5)
#define WHICH_OPTIONAL  (1 << 6)
 
#define WHICH_DEFAULT   (WHICH_PIF | WHICH_COM | WHICH_EXE | WHICH_BAT | WHICH_LNK | WHICH_CMD)
 
/* dwClass flags for PathIsValidCharA and PathIsValidCharW */
#define PATH_CHAR_CLASS_LETTER      0x00000001
#define PATH_CHAR_CLASS_ASTERIX     0x00000002
#define PATH_CHAR_CLASS_DOT         0x00000004
#define PATH_CHAR_CLASS_BACKSLASH   0x00000008
#define PATH_CHAR_CLASS_COLON       0x00000010
#define PATH_CHAR_CLASS_SEMICOLON   0x00000020
#define PATH_CHAR_CLASS_COMMA       0x00000040
#define PATH_CHAR_CLASS_SPACE       0x00000080
#define PATH_CHAR_CLASS_OTHER_VALID 0x00000100
#define PATH_CHAR_CLASS_DOUBLEQUOTE 0x00000200
#define PATH_CHAR_CLASS_INVALID     0x00000000
#define PATH_CHAR_CLASS_ANY         0xffffffff
 
BOOL WINAPI PathFileExistsDefExtW(LPWSTR lpszPath, DWORD dwWhich);
 
BOOL WINAPI
PathFileExistsDefExtAndAttributesW(
    _Inout_ LPWSTR pszPath,
    _In_ DWORD dwWhich,
    _Out_opt_ LPDWORD pdwFileAttributes);
 
BOOL WINAPI
PathUnExpandEnvStringsForUserA(
    _In_ HANDLE hUserToken,
    _In_ PCSTR pszPath,
    _Out_writes_(cchBuff) PSTR pszBuff,
    _In_ INT cchBuff);
 
BOOL WINAPI
PathUnExpandEnvStringsForUserW(
    _In_ HANDLE hUserToken,
    _In_ PCWSTR pwszPath,
    _Out_writes_(cchBuff) PWSTR pszBuff,
    _In_ INT cchBuff);
 
BOOL WINAPI PathFindOnPathExW(LPWSTR lpszFile, LPCWSTR *lppszOtherDirs, DWORD dwWhich);
VOID WINAPI FixSlashesAndColonA(_Inout_ LPSTR lpstr);
VOID WINAPI FixSlashesAndColonW(_Inout_ LPWSTR lpwstr);
BOOL WINAPI PathIsValidCharA(char c, DWORD dwClass);
BOOL WINAPI PathIsValidCharW(WCHAR c, DWORD dwClass);
BOOL WINAPI SHGetPathFromIDListWrapW(LPCITEMIDLIST pidl, LPWSTR pszPath);
#ifndef _SHLWAPI_
DECLSPEC_IMPORT BOOL WINAPI PathFileExistsAndAttributesA(LPCSTR lpszPath, DWORD* dwAttr);
DECLSPEC_IMPORT BOOL WINAPI PathFileExistsAndAttributesW(LPCWSTR lpszPath, DWORD* dwAttr);
#else
BOOL WINAPI PathFileExistsAndAttributesA(LPCSTR lpszPath, DWORD* dwAttr);
BOOL WINAPI PathFileExistsAndAttributesW(LPCWSTR lpszPath, DWORD* dwAttr);
#endif
 
VOID WINAPI PrettifyFileDescriptionW(_Inout_ PWSTR pszTarget, _In_opt_ PCWSTR pszCutList);
 
BOOL WINAPI SHGetFileDescriptionA(
    _In_ PCSTR pszPath,
    _In_opt_ PCSTR pszVerKey,
    _In_opt_ PCSTR pszDisplayName,
    _Out_opt_ PSTR pszOut,
    _Inout_ PUINT pcchOut);
 
BOOL WINAPI SHGetFileDescriptionW(
    _In_ PCWSTR pszPath,
    _In_opt_ PCWSTR pszVerKey,
    _In_opt_ PCWSTR pszDisplayName,
    _Out_opt_ PWSTR pszOut,
    _Inout_ PUINT pcchOut);
 
LPSTR  WINAPI StrCpyNXA(LPSTR lpszDest, LPCSTR lpszSrc, int iLen);
LPWSTR WINAPI StrCpyNXW(LPWSTR lpszDest, LPCWSTR lpszSrc, int iLen);
 
#ifdef UNICODE
    #define PathIsValidChar PathIsValidCharW
    #define StrCpyNX StrCpyNXW
    #define FixSlashesAndColon FixSlashesAndColonW
    #define SHGetFileDescription SHGetFileDescriptionW
#else
    #define PathIsValidChar PathIsValidCharA
    #define StrCpyNX StrCpyNXA
    #define FixSlashesAndColon FixSlashesAndColonA
    #define SHGetFileDescription SHGetFileDescriptionA
#endif
 
BOOL WINAPI
IContextMenu_Invoke(
    _In_ IContextMenu *pContextMenu,
    _In_ HWND hwnd,
    _In_ LPCSTR lpVerb,
    _In_ UINT uFlags);
 
HRESULT WINAPI RunRegCommand(_In_opt_ HWND hWnd, _In_ HKEY hKey, _In_opt_ PCWSTR pszSubKey);
HRESULT WINAPI RunIndirectRegCommand(_In_opt_ HWND hWnd, _In_ HKEY hKey, _In_opt_ PCWSTR pszSubKey, _In_ PCWSTR pszVerb);
HRESULT WINAPI SHRunIndirectRegClientCommand(_In_ HWND hWnd, _In_ PCWSTR pszClientType);
 
DWORD WINAPI SHGetObjectCompatFlags(IUnknown *pUnk, const CLSID *clsid);
 
/* Flags for SHGetAppCompatFlags */
#define SHACF_CONTEXTMENU           0x00000001
#define SHACF_FLUSHNOWAITALWAYS     SHACF_CONTEXTMENU
#define SHACF_DOCOBJECT             0x00000002
#define SHACF_CORELINTERNETENUM     0x00000004
#define SHACF_OLDCREATEVIEWWND      SHACF_CORELINTERNETENUM
#define SHACF_WIN95DEFVIEW          SHACF_CORELINTERNETENUM
#define SHACF_MYCOMPUTERFIRST       0x00000008
#define SHACF_OLDREGITEMGDN         0x00000010
// 0x00000020
#define SHACF_LOADCOLUMNHANDLER     0x00000040
#define SHACF_ANSI                  0x00000080
#define SHACF_UNKNOWN1              0x00000100
#define SHACF_WIN95SHLEXEC          0x00000200
#define SHACF_STAROFFICE5PRINTER    0x00000400
#define SHACF_NOVALIDATEFSIDS       0x00000800
#define SHACF_FILEOPENNEEDSEXT      0x00001000
#define SHACF_WIN95BINDTOOBJECT     0x00002000
#define SHACF_IGNOREENUMRESET       0x00004000
// 0x00008000
#define SHACF_ANSIDISPLAYNAMES      0x00010000
#define SHACF_FILEOPENBOGUSCTRLID   0x00020000
#define SHACF_FORCELFNIDLIST        0x00040000
// 0x00080000
#define SHACF_UNKNOWN2              0x01000000
#define SHACF_UNKNOWN3              0x80000000
 
DWORD WINAPI SHGetAppCompatFlags(_In_ DWORD dwMask);
 
HRESULT WINAPI
IUnknown_QueryServiceForWebBrowserApp(
    _In_ IUnknown* lpUnknown,
    _In_ REFGUID riid,
    _Out_ LPVOID *lppOut);
 
typedef INT_PTR (CALLBACK *SHDIALOGPROC)(
    PVOID  pThis,
    HWND   hWnd,
    UINT   uMsg,
    WPARAM wParam,
    LPARAM lParam);
 
INT_PTR WINAPI
SHDialogBox(
    _In_opt_ HINSTANCE hInstance,
    _In_ PCSTR lpTemplateName,
    _In_opt_ HWND hWndParent,
    _In_opt_ SHDIALOGPROC fn,
    _In_opt_ PVOID pThis);
 
HRESULT WINAPI MapWin32ErrorToSTG(_In_ HRESULT hr);
 
PSTR WINAPI CharLowerNoDBCSA(_Inout_ PSTR lpString);
PWSTR WINAPI CharLowerNoDBCSW(_Inout_ PWSTR lpString);
PSTR WINAPI CharUpperNoDBCSA(_Inout_ PSTR lpString);
PWSTR WINAPI CharUpperNoDBCSW(_Inout_ PWSTR lpString);
 
HRESULT WINAPI
SHWindowsPolicyGetValue(
    _In_ REFGUID rpolid,
    _Out_opt_ PVOID pvValue,
    _Out_opt_ PDWORD pcbValue);
 
#define E_DATATYPE_MISMATCH HRESULT_FROM_WIN32(ERROR_DATATYPE_MISMATCH)
 
static inline BOOL
PathIsAbsolute(_In_ PCWSTR pszPath)
{
    return (PathGetDriveNumberW(pszPath) != -1 && pszPath[2] == L'\\') || PathIsUNCW(pszPath);
}
 
static inline HRESULT
SHCoAlloc(_In_ SIZE_T cb, _Outptr_ PVOID* ppData)
{
    *ppData = CoTaskMemAlloc(cb);
    return *ppData ? S_OK : E_OUTOFMEMORY;
}
 
static inline DWORD
SHWindowsPolicyEx(_In_ REFGUID rpolid, _In_ DWORD dwDefaultValue)
{
    DWORD dwData, cbData = sizeof(dwData);
    HRESULT hr = SHWindowsPolicyGetValue(rpolid, &dwData, &cbData);
    return (SUCCEEDED(hr) ? dwData : dwDefaultValue);
}
 
#if (NTDDI_VERSION >= NTDDI_LONGHORN) || defined(_SHELL32_)
HRESULT WINAPI
AssocCreateElement(_In_ REFCLSID rclsid, _In_ REFIID riid, _Outptr_ PVOID* ppvObj);
#endif
 
/*****************************************************************************
 * ZoneCheck*
 */
 
HRESULT WINAPI
ZoneCheckUrlExCacheA(
    _In_                             PCSTR                     pszUrl,
    _Out_writes_bytes_opt_(cbPolicy) PBYTE                     pbPolicy,
    _In_                             DWORD                     cbPolicy,
    _In_reads_bytes_opt_(cbContext)  PBYTE                     pbContext,
    _In_                             DWORD                     cbContext,
    _In_                             DWORD                     dwAction,
    _In_                             DWORD                     dwFlags,
    _In_opt_                         IInternetSecurityMgrSite *pSecuritySite,
    _In_opt_                         IInternetSecurityManager *pISM);
 
HRESULT WINAPI
ZoneCheckUrlExCacheW(
    _In_                             PCWSTR                    pszUrl,
    _Out_writes_bytes_opt_(cbPolicy) PBYTE                     pbPolicy,
    _In_                             DWORD                     cbPolicy,
    _In_reads_bytes_opt_(cbContext)  PBYTE                     pbContext,
    _In_                             DWORD                     cbContext,
    _In_                             DWORD                     dwAction,
    _In_                             DWORD                     dwFlags,
    _In_opt_                         IInternetSecurityMgrSite *pSecuritySite,
    _In_opt_                         IInternetSecurityManager *pISM);
 
HRESULT WINAPI
ZoneCheckPathA(
    _In_     PCSTR pszPath,
    _In_     DWORD dwAction,
    _In_     DWORD dwFlags,
    _In_opt_ IInternetSecurityMgrSite *pSecuritySite);
 
HRESULT WINAPI
ZoneCheckPathW(
    _In_     PCWSTR pszPath,
    _In_     DWORD dwAction,
    _In_     DWORD dwFlags,
    _In_opt_ IInternetSecurityMgrSite *pSecuritySite);
 
HRESULT WINAPI
ZoneCheckUrlA(
    _In_     PCSTR   pszUrl,
    _In_     DWORD   dwAction,
    _In_     DWORD   dwFlags,
    _In_opt_ IInternetSecurityMgrSite *pSecuritySite);
 
HRESULT WINAPI
ZoneCheckUrlW(
    _In_     PCWSTR  pszUrl,
    _In_     DWORD   dwAction,
    _In_     DWORD   dwFlags,
    _In_opt_ IInternetSecurityMgrSite *pSecuritySite);
 
HRESULT WINAPI
ZoneCheckUrlExA(
    _In_                             PCSTR   pszUrl,
    _Out_writes_bytes_opt_(cbPolicy) PBYTE   pbPolicy,
    _In_                             DWORD   cbPolicy,
    _In_reads_bytes_opt_(cbContext)  PBYTE   pbContext,
    _In_                             DWORD   cbContext,
    _In_                             DWORD   dwAction,
    _In_                             DWORD   dwFlags,
    _In_opt_                         IInternetSecurityMgrSite *pSecuritySite);
 
HRESULT WINAPI
ZoneCheckUrlExW(
    _In_                             PCWSTR  pszUrl,
    _Out_writes_bytes_opt_(cbPolicy) PBYTE   pbPolicy,
    _In_                             DWORD   cbPolicy,
    _In_reads_bytes_opt_(cbContext)  PBYTE   pbContext,
    _In_                             DWORD   cbContext,
    _In_                             DWORD   dwAction,
    _In_                             DWORD   dwFlags,
    _In_opt_                         IInternetSecurityMgrSite *pSecuritySite);
 
HRESULT WINAPI
ZoneCheckHost(
    _In_   IInternetSecurityManager  *pISM,
    _In_   PCWSTR                     pszUrl,
    _In_   DWORD                      dwAction);
 
HRESULT WINAPI
ZoneCheckHostEx(
    _In_                             IInternetSecurityManager *pISM,
    _Out_writes_bytes_opt_(cbPolicy) PBYTE                     pbPolicy,
    _In_                             DWORD                     cbPolicy,
    _In_reads_bytes_opt_(cbContext)  PBYTE                     pbContext,
    _In_                             DWORD                     cbContext,
    _In_                             PCWSTR                    pszUrl,
    _In_                             DWORD                     dwAction);
 
#ifdef UNICODE
    #define ZoneCheckUrlExCache ZoneCheckUrlExCacheW
    #define ZoneCheckPath ZoneCheckPathW
    #define ZoneCheckUrl ZoneCheckUrlW
    #define ZoneCheckUrlEx ZoneCheckUrlExW
#else
    #define ZoneCheckUrlExCache ZoneCheckUrlExCacheA
    #define ZoneCheckPath ZoneCheckPathA
    #define ZoneCheckUrl ZoneCheckUrlA
    #define ZoneCheckUrlEx ZoneCheckUrlExA
#endif
 
#ifdef __cplusplus
} /* extern "C" */
#endif