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

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

S_EQUAL

#define S_EQUAL   S_OK

Definition at line 577 of file shellutils.h.

S_GREATERTHAN

#define S_GREATERTHAN   S_FALSE

Definition at line 578 of file shellutils.h.

S_LESSTHAN

#define S_LESSTHAN   0xffff

Definition at line 576 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 586 of file shellutils.h.

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

Referenced by _ShowPropertiesDialogThread(), DoGetFileTitle(), CCopyMoveToMenu::DoRealFileOp(), CFontExt::Drop(), CMyDocsDropHandler::Drop(), CDeskLinkDropHandler::Drop(), CCopyAsPathMenu::Drop(), COpenWithMenu::Initialize(), SH_ShowDriveProperties(), SH_ShowPropertiesDialog(), SHGetAttributesFromDataObject(), and TestHIDA().

HIDA_GetPIDLItem()

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

inlinestatic

Definition at line 591 of file shellutils.h.

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

Referenced by _ShowPropertiesDialogThread(), DoGetFileTitle(), CCopyMoveToMenu::DoRealFileOp(), CFontExt::Drop(), CMyDocsDropHandler::Drop(), CDeskLinkDropHandler::Drop(), CCopyAsPathMenu::Drop(), FontFolderMenuCallback(), COpenWithMenu::Initialize(), SH_ShowPropertiesDialog(), 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 OpenServiceHelper().

ILIsSingle()

static BOOL ILIsSingle ( LPCITEMIDLIST  pidl )

inlinestatic

Definition at line 581 of file shellutils.h.

{
    return pidl == ILFindLastID(pidl);
}

Referenced by SHOpenFolderAndSelectItems().

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