prop.h File Reference

#include "precomp.h"

Include dependency graph for prop.h:

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

Go to the source code of this file.

Macros
#define	SHELL32_NOPROPSYSLIB
#define	DEFINE_SHELL32PROPERTYKEY(name, psguid, pid)   EXTERN_C const PROPERTYKEY name

Functions
	DEFINE_SHELL32PROPERTYKEY (PKEY_Size, PSGUID_STORAGE, PID_STG_SIZE)
	DEFINE_SHELL32PROPERTYKEY (PKEY_FileAttributes, PSGUID_STORAGE, PID_STG_ATTRIBUTES)
	DEFINE_SHELL32PROPERTYKEY (PKEY_DateModified, PSGUID_STORAGE, PID_STG_WRITETIME)
	DEFINE_SHELL32PROPERTYKEY (PKEY_ItemTypeText, PSGUID_STORAGE, PID_STG_STORAGETYPE)
	DEFINE_SHELL32PROPERTYKEY (PKEYSHELL32_Name, PSGUID_STORAGE, PID_STG_NAME)
	DEFINE_SHELL32PROPERTYKEY (PKEYSHELL32_Comments, PSGUID_SUMMARYINFORMATION, PIDSI_COMMENTS)
const PROPERTYKEY *	SHELL_GetPropertyKeyFromString (_In_ PCWSTR pszString, _Out_ PROPERTYKEY *pkey)
static VARIANT *	VariantDerefVariant (_In_ const VARIANT *pV)
HRESULT	VariantToIdlist (_In_ VARIANT *pV, _Out_ LPITEMIDLIST *ppidl)
HRESULT	VariantQueryInterface (_In_ VARIANT *pV, _In_ REFIID riid, _Out_ void **ppv)

Macro Definition Documentation

DEFINE_SHELL32PROPERTYKEY

#define DEFINE_SHELL32PROPERTYKEY	(		name,
			psguid,
			pid
	)		EXTERN_C const PROPERTYKEY name

Definition at line 20 of file prop.h.

SHELL32_NOPROPSYSLIB

#define SHELL32_NOPROPSYSLIB

Definition at line 10 of file prop.h.

Function Documentation

DEFINE_SHELL32PROPERTYKEY() [1/6]

DEFINE_SHELL32PROPERTYKEY	(	PKEY_DateModified	,
		PSGUID_STORAGE	,
		PID_STG_WRITETIME
	)

DEFINE_SHELL32PROPERTYKEY() [2/6]

DEFINE_SHELL32PROPERTYKEY	(	PKEY_FileAttributes	,
		PSGUID_STORAGE	,
		PID_STG_ATTRIBUTES
	)

DEFINE_SHELL32PROPERTYKEY() [3/6]

DEFINE_SHELL32PROPERTYKEY	(	PKEY_ItemTypeText	,
		PSGUID_STORAGE	,
		PID_STG_STORAGETYPE
	)

DEFINE_SHELL32PROPERTYKEY() [4/6]

DEFINE_SHELL32PROPERTYKEY	(	PKEY_Size	,
		PSGUID_STORAGE	,
		PID_STG_SIZE
	)

DEFINE_SHELL32PROPERTYKEY() [5/6]

DEFINE_SHELL32PROPERTYKEY	(	PKEYSHELL32_Comments	,
		PSGUID_SUMMARYINFORMATION	,
		PIDSI_COMMENTS
	)

DEFINE_SHELL32PROPERTYKEY() [6/6]

DEFINE_SHELL32PROPERTYKEY	(	PKEYSHELL32_Name	,
		PSGUID_STORAGE	,
		PID_STG_NAME
	)

SHELL_GetPropertyKeyFromString()

const PROPERTYKEY * SHELL_GetPropertyKeyFromString	(	_In_ PCWSTR	pszString,
		_Out_ PROPERTYKEY *	pkey
	)

Definition at line 60 of file prop.cpp.

{
    if (SUCCEEDED(SHELL_PropertyKeyFromPropertyKeyString(pszString, pkey)))
        return pkey;
    return SHELL_GetPropertyKeyFromLegacyName(pszString);
}

Referenced by CFolderItem::ExtendedProperty().

VariantDerefVariant()

static VARIANT * VariantDerefVariant ( _In_ const VARIANT *  pV )

inlinestatic

Definition at line 36 of file prop.h.

{
    if (V_VT(pV) == (VT_BYREF | VT_VARIANT) && V_VARIANTREF(pV))
        return V_VARIANTREF(pV);
    return (VARIANT*)pV;
}

Referenced by CFolderItem::GetParentAndItem(), and VariantQueryInterface().

VariantQueryInterface()

HRESULT VariantQueryInterface	(	_In_ VARIANT *	pV,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 83 of file prop.cpp.

{
    pV = VariantDerefVariant(pV);
    switch (V_VT(pV))
    {
        case VT_DISPATCH | VT_BYREF:
            return V_DISPATCHREF(pV) && *V_DISPATCHREF(pV) ? (*V_DISPATCHREF(pV))->QueryInterface(riid, ppv) : E_UNEXPECTED;
        case VT_DISPATCH:
        case VT_UNKNOWN:
            return V_UNKNOWN(pV) ? V_UNKNOWN(pV)->QueryInterface(riid, ppv) : E_UNEXPECTED;
    }
    return E_FAIL;
}

Referenced by CFolder::GetUIObjectFromVariant().

VariantToIdlist()

HRESULT VariantToIdlist	(	_In_ VARIANT *	pV,
		_Out_ LPITEMIDLIST *	ppidl
	)

Definition at line 68 of file prop.cpp.

{
    HRESULT hr = E_FAIL;
    if (V_VT(pV) == VT_I4)
    {
        hr = SHGetSpecialFolderLocation(NULL, V_I4(pV), ppidl);
    }
    else if (V_VT(pV) == VT_BSTR)
    {
        hr = SHILCreateFromPathW(V_BSTR(pV), ppidl, NULL);
    }
    return hr;
}

Referenced by CShellDispatch::AddToRecent(), CShellDispatch::BrowseForFolder(), CFolder::GetUIObjectFromVariant(), CShellDispatch::NameSpace(), and OpenFolder().