shellutils.h File Reference

Go to the source code of this file.

Macros
#define	DbgPrint(fmt, ...)    Win32DbgPrint(__FILE__, __LINE__, fmt, ##__VA_ARGS__)
#define	IID_PPV_ARG(Itype, ppType)   &IID_##Itype, (void**)(ppType)
#define	IID_NULL_PPV_ARG(Itype, ppType)   &IID_##Itype, NULL, (void**)(ppType)
#define	FAILED_UNEXPECTEDLY(hr)   _ROS_FAILED_HELPER((hr), #hr, __FILE__, __LINE__)
#define	SHELL_ErrorBox   SHELL_ErrorBoxHelper
#define	S_LESSTHAN   0xffff
#define	S_EQUAL   S_OK
#define	S_GREATERTHAN   S_FALSE
#define	MAKE_COMPARE_HRESULT(x)   ((x)>0 ? S_GREATERTHAN : ((x)<0 ? S_LESSTHAN : S_EQUAL))
#define	SEE_CMIC_COMMON_BASICFLAGS
#define	SEE_CMIC_COMMON_FLAGS
#define	SHELL_GetSetting(pss, ssf, field)   ( SHGetSetSettings((pss), (ssf), FALSE), (pss)->field )

Functions
static ULONG	Win32DbgPrint (const char *filename, int line, const char *lpFormat,...)
static HRESULT	HResultFromWin32 (DWORD hr)
static BOOL	_ROS_FAILED_HELPER (HRESULT hr, const char *expr, const char *filename, int line)
static UINT	SHELL_ErrorBoxHelper (HWND hwndOwner, UINT Error)
static BOOL	ILIsSingle (LPCITEMIDLIST pidl)
static PCUIDLIST_ABSOLUTE	HIDA_GetPIDLFolder (CIDA const *pida)
static PCUIDLIST_RELATIVE	HIDA_GetPIDLItem (CIDA const *pida, SIZE_T i)
static void	DumpIdListOneLine (LPCITEMIDLIST pidl)

Macro Definition Documentation

DbgPrint

#define DbgPrint	(		fmt,
			...
	)		Win32DbgPrint(__FILE__, __LINE__, fmt, ##__VA_ARGS__)

Definition at line 59 of file shellutils.h.

FAILED_UNEXPECTEDLY

#define FAILED_UNEXPECTEDLY

(

hr

)

_ROS_FAILED_HELPER((hr), #hr, __FILE__, __LINE__)

Definition at line 88 of file shellutils.h.

IID_NULL_PPV_ARG

#define IID_NULL_PPV_ARG	(		Itype,
			ppType
	)		&IID_##Itype, NULL, (void**)(ppType)

Definition at line 67 of file shellutils.h.

IID_PPV_ARG

#define IID_PPV_ARG	(		Itype,
			ppType
	)		&IID_##Itype, (void**)(ppType)

Definition at line 66 of file shellutils.h.

MAKE_COMPARE_HRESULT

#define MAKE_COMPARE_HRESULT

(

x

)

((x)>0 ? S_GREATERTHAN : ((x)<0 ? S_LESSTHAN : S_EQUAL))

Definition at line 623 of file shellutils.h.

S_EQUAL

#define S_EQUAL   S_OK

Definition at line 621 of file shellutils.h.

S_GREATERTHAN

#define S_GREATERTHAN   S_FALSE

Definition at line 622 of file shellutils.h.

S_LESSTHAN

#define S_LESSTHAN   0xffff

Definition at line 620 of file shellutils.h.

SEE_CMIC_COMMON_BASICFLAGS

#define SEE_CMIC_COMMON_BASICFLAGS

Value:

                                    (SEE_MASK_NOASYNC | SEE_MASK_ASYNCOK | SEE_MASK_UNICODE | \
                                    SEE_MASK_NO_CONSOLE | SEE_MASK_FLAG_NO_UI | SEE_MASK_FLAG_SEPVDM | \
                                    SEE_MASK_FLAG_LOG_USAGE | SEE_MASK_NOZONECHECKS)

Definition at line 625 of file shellutils.h.

SEE_CMIC_COMMON_FLAGS

#define SEE_CMIC_COMMON_FLAGS

Value:

                                    (SEE_CMIC_COMMON_BASICFLAGS | SEE_MASK_HOTKEY | SEE_MASK_ICON | \
                                    SEE_MASK_HASLINKNAME | SEE_MASK_HASTITLE)

Definition at line 628 of file shellutils.h.

SHELL_ErrorBox

#define SHELL_ErrorBox   SHELL_ErrorBoxHelper

Definition at line 126 of file shellutils.h.

SHELL_GetSetting

#define SHELL_GetSetting	(		pss,
			ssf,
			field
	)		( SHGetSetSettings((pss), (ssf), FALSE), (pss)->field )

Definition at line 830 of file shellutils.h.

Function Documentation

_ROS_FAILED_HELPER()

static BOOL _ROS_FAILED_HELPER ( HRESULT  hr, const char *  expr, const char *  filename, int  line  )

inlinestatic

Definition at line 78 of file shellutils.h.

{
    if (FAILED(hr))
    {
        Win32DbgPrint(filename, line, "Unexpected failure (%s)=%08x.\n", expr, hr);
        return TRUE;
    }
    return FALSE;
}

DumpIdListOneLine()

static void DumpIdListOneLine ( LPCITEMIDLIST  pidl )

inlinestatic

Definition at line 833 of file shellutils.h.

{
    char buf[1024], *data, drive = 0;
    for (UINT depth = 0, type; ; pidl = ILGetNext(pidl), ++depth)
    {
        if (!pidl || !pidl->mkid.cb)
        {
            if (!depth)
            {
                wsprintfA(buf, "%p [] (%s)\n", pidl, pidl ? "Empty/Desktop" : "NULL");
                OutputDebugStringA(buf);
            }
            break;
        }
        else if (!depth)
        {
            wsprintfA(buf, "%p", pidl);
            OutputDebugStringA(buf);
        }
        type = pidl->mkid.abID[0] & 0x7f;
        data = (char*)&pidl->mkid.abID[0];
        if (depth == 0 && type == 0x1f && pidl->mkid.cb == 20 && *(UINT*)(&data[2]) == 0x20D04FE0)
        {
            wsprintfA(buf, " [%.2x ThisPC?]", type); /* "?" because we did not check the full GUID */
        }
        else if (depth == 1 && type >= 0x20 && type < 0x30 && type != 0x2E && pidl->mkid.cb > 4)
        {
            drive = data[1];
            wsprintfA(buf, " [%.2x %c: %ub]", type, drive, pidl->mkid.cb);
        }
        else if (depth >= 2 && drive && (type & 0x70) == 0x30) /* PT_FS */
        {
            if (type & 4)
                wsprintfA(buf, " [%.2x FS %.256ls %ub]", type, data + 12, pidl->mkid.cb);
            else
                wsprintfA(buf, " [%.2x FS %.256hs %ub]", type, data + 12, pidl->mkid.cb);
        }
        else
        {
            wsprintfA(buf, " [%.2x ? %ub]", type, pidl->mkid.cb);
        }
        OutputDebugStringA(buf);
    }
    OutputDebugStringA("\n");
}

HIDA_GetPIDLFolder()

static PCUIDLIST_ABSOLUTE HIDA_GetPIDLFolder ( CIDA const *  pida )

inlinestatic

Definition at line 636 of file shellutils.h.

{
    return (PCUIDLIST_ABSOLUTE)(((LPBYTE)pida) + (pida)->aoffset[0]);
}

Referenced by CFontExt::Drop(), CMyDocsDropHandler::Drop(), CDeskLinkDropHandler::Drop(), CShellItemArray::GetItemAt(), COpenWithMenu::Initialize(), SHELL_CIDA_ILCloneFull(), SHELL_CloneDataObject(), SHGetAttributesFromDataObject(), and TestHIDA().

HIDA_GetPIDLItem()

static PCUIDLIST_RELATIVE HIDA_GetPIDLItem ( CIDA const *  pida, SIZE_T  i  )

inlinestatic

Definition at line 641 of file shellutils.h.

{
    return (PCUIDLIST_RELATIVE)(((LPBYTE)pida) + (pida)->aoffset[i + 1]);
}

Referenced by CFontExt::Drop(), CMyDocsDropHandler::Drop(), CDeskLinkDropHandler::Drop(), ExtractFilesCallback(), FontFolderMenuCallback(), FSFolderItemPropDialogInitCallback(), CShellItemArray::GetItemAt(), COpenWithMenu::Initialize(), SHELL32_ShowFilesystemItemPropertiesDialogAsync(), SHELL_CIDA_ILCloneFull(), SHGetAttributesFromDataObject(), and TestHIDA().

HResultFromWin32()

static HRESULT HResultFromWin32 ( DWORD  hr )

inlinestatic

Definition at line 70 of file shellutils.h.

{
     // HRESULT_FROM_WIN32 will evaluate its parameter twice, this function will not.
    return HRESULT_FROM_WIN32(hr);
}

ILIsSingle()

static BOOL ILIsSingle ( LPCITEMIDLIST  pidl )

inlinestatic

Definition at line 631 of file shellutils.h.

{
    return pidl == ILFindLastID(pidl);
}

Referenced by CCabFolder::CompareIDs(), and SHOpenFolderAndSelectItems().

SHELL_ErrorBoxHelper()

static UINT SHELL_ErrorBoxHelper ( HWND  hwndOwner, UINT  Error  )

inlinestatic

Definition at line 98 of file shellutils.h.

{
    WCHAR buf[400];
    UINT cch;
 
    if (!IsWindowVisible(hwndOwner))
        hwndOwner = NULL;
    if (Error == ERROR_SUCCESS)
        Error = ERROR_INTERNAL_ERROR;
 
    cch = FormatMessageW(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS,
                         NULL, Error, 0, buf, _countof(buf), NULL);
    if (!cch)
    {
        enum { user32_IDS_ERROR = 2 }; // IDS_ERROR from user32 resource.h ("Error" string)
        cch = LoadStringW(LoadLibraryW(L"USER32"), user32_IDS_ERROR, buf, _countof(buf));
        wsprintfW(buf + cch, L"\n\n%#x (%d)", Error, Error);
    }
    MessageBoxW(hwndOwner, buf, NULL, MB_OK | MB_ICONSTOP);
    return Error;
}

Win32DbgPrint()

static ULONG Win32DbgPrint ( const char *  filename, int  line, const char *  lpFormat,   ...  )

inlinestatic

Definition at line 27 of file shellutils.h.

{
    char szMsg[512];
    char *szMsgStart;
    const char *fname;
    va_list vl;
 
    fname = strrchr(filename, '\\');
    if (fname == NULL)
    {
        fname = strrchr(filename, '/');
        if (fname != NULL)
            fname++;
    }
    else
        fname++;
 
    if (fname == NULL)
        fname = filename;
 
    szMsgStart = szMsg + sprintf(szMsg, "%s:%d: ", fname, line);
 
    va_start(vl, lpFormat);
    vsprintf(szMsgStart, lpFormat, vl);
    va_end(vl);
 
    OutputDebugStringA(szMsg);
 
    /* Return STATUS_SUCCESS, since we are supposed to mimic DbgPrint */
    return 0;
}

Referenced by _ROS_FAILED_HELPER().