shellutils.h File Reference

This graph shows which files directly or indirectly include this file:

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	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	SHELL_GetSetting(pss, ssf, field)   ( SHGetSetSettings((pss), (ssf), FALSE), (pss)->field )

Functions
ULONG	Win32DbgPrint (const char *filename, int line, const char *lpFormat,...)
HRESULT	HResultFromWin32 (DWORD hr)
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)

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 610 of file shellutils.h.

S_EQUAL

#define S_EQUAL   S_OK

Definition at line 608 of file shellutils.h.

S_GREATERTHAN

#define S_GREATERTHAN   S_FALSE

Definition at line 609 of file shellutils.h.

S_LESSTHAN

#define S_LESSTHAN   0xffff

Definition at line 607 of file shellutils.h.

SHELL_GetSetting

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

Definition at line 798 of file shellutils.h.

Function Documentation

_ROS_FAILED_HELPER()

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

inline

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;
}

HIDA_GetPIDLFolder()

static PCUIDLIST_ABSOLUTE HIDA_GetPIDLFolder ( CIDA const *  pida )

inlinestatic

Definition at line 617 of file shellutils.h.

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

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

HIDA_GetPIDLItem()

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

inlinestatic

Definition at line 622 of file shellutils.h.

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

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

HResultFromWin32()

HRESULT HResultFromWin32 ( DWORD  hr )

inline

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);
}

Referenced by LoadColumnsStream(), CDefView::LoadViewState(), OpenServiceHelper(), CTrayWindowCtxMenu::QueryContextMenu(), Read(), CGlobalFolderSettings::Save(), CFSFolder::SetNameOf(), and SHELL32_ShowPropertiesDialog().

ILIsSingle()

static BOOL ILIsSingle ( LPCITEMIDLIST  pidl )

inlinestatic

Definition at line 612 of file shellutils.h.

{
    return pidl == ILFindLastID(pidl);
}

Referenced by 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()

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

inline

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().