propsys.idl File Reference

Go to the source code of this file.

Classes
interface	IInitializeWithFile
interface	IInitializeWithStream
interface	IPropertyStore
interface	v1_enum
interface	IPropertyChange
interface	IPropertyChangeArray
interface	IPropertyStoreCapabilities
interface	IPropertyStoreCache
interface	IPropertyEnumType
interface	IPropertyEnumType2
interface	IPropertyEnumTypeList
interface	IPropertyDescription
interface	IPropertyDescription2
interface	IPropertyDescriptionAliasInfo
interface	IPropertyDescriptionSearchInfo
interface	IPropertySystem
interface	IPropertyDescriptionList
interface	IPropertyStoreFactory
interface	IDelayedPropertyStoreFactory
interface	IPersistSerializedPropStorage
interface	IPersistSerializedPropStorage2
interface	IPropertySystemChangeNotify
interface	ICreateObject
class	PropSysObjects::InMemoryPropertyStore

Modules
library	PropSysObjects

Typedefs
typedef PROPERTYKEY *	REFPROPERTYKEY
typedef v1_enum	GPS_HANDLERPROPERTIESONLY = 0x01
typedef v1_enum	GPS_READWRITE = 0x02
typedef v1_enum	GPS_TEMPORARY = 0x04
typedef v1_enum	GPS_FASTPROPERTIESONLY = 0x08
typedef v1_enum	GPS_OPENSLOWITEM = 0x10
typedef v1_enum	GPS_DELAYCREATION = 0x20
typedef v1_enum	GPS_BESTEFFORT = 0x40
typedef v1_enum	GPS_NO_OPLOCK = 0x80
typedef v1_enum	GPS_MASK_VALID
typedef v1_enum	PKA_APPEND
typedef v1_enum	PKA_FLAGS
typedef v1_enum	PDEF_SYSTEM
typedef v1_enum	PDEF_NONSYSTEM
typedef v1_enum	PDEF_VIEWABLE
typedef v1_enum	PDEF_QUERYABLE
typedef v1_enum	PDEF_INFULLTEXTQUERY
typedef v1_enum	PROPDESC_ENUMFILTER
typedef int	PERSIST_SPROPSTORE_FLAGS
typedef struct tagSERIALIZEDROPSTORAGE	SERIALIZEDPROPSTORAGE
typedef SERIALIZEDPROPSTORAGE *	PUSERIALIZEDPROPSTORAGE
typedef const SERIALIZEDPROPSTORAGE *	PCUSERIALIZEDPROPSTORAGE

Enumerations
enum	_PERSIST_SPROPSTORE_FLAGS { FPSPS_DEFAULT = 0 , FPSPS_READONLY = 1 }

Functions
	DEFINE_ENUM_FLAG_OPERATORS (GETPROPERTYSTOREFLAGS)[uuid(fc0ca0a7-c316-4fd2-9031-3e628e6d4f23)
PSSTDAPI	PSCreateMemoryPropertyStore (REFIID, void **)
PSSTDAPI	PSCreatePropertyStoreFromObject (IUnknown *, DWORD, REFIID, void **)
PSSTDAPI	PSStringFromPropertyKey (REFPROPERTYKEY, LPWSTR, UINT)
PSSTDAPI	PSPropertyKeyFromString (LPCWSTR, PROPERTYKEY *)
PSSTDAPI	PSGetPropertyDescription (REFPROPERTYKEY, REFIID, void **)
PSSTDAPI	PSGetPropertyDescriptionListFromString (LPCWSTR, REFIID, void **)
PSSTDAPI	PSRefreshPropertySchema (void)
PSSTDAPI	PSRegisterPropertySchema (LPCWSTR)
PSSTDAPI	PSUnregisterPropertySchema (LPCWSTR)
coclass PropSysObjects::InMemoryPropertyStore	PropSysObjects::uuid (b8967f85-58ae-4f46-9fb2-5d7904798f4b)] coclass PropertySystem

Typedef Documentation

GPS_BESTEFFORT

typedef v1_enum GPS_BESTEFFORT = 0x40

GPS_DELAYCREATION

typedef v1_enum GPS_DELAYCREATION = 0x20

GPS_FASTPROPERTIESONLY

typedef v1_enum GPS_FASTPROPERTIESONLY = 0x08

GPS_HANDLERPROPERTIESONLY

typedef v1_enum GPS_HANDLERPROPERTIESONLY = 0x01

GPS_MASK_VALID

typedef v1_enum GPS_MASK_VALID

Initial value:

= 0xff
} GETPROPERTYSTOREFLAGS

GPS_NO_OPLOCK

typedef v1_enum GPS_NO_OPLOCK = 0x80

GPS_OPENSLOWITEM

typedef v1_enum GPS_OPENSLOWITEM = 0x10

GPS_READWRITE

typedef v1_enum GPS_READWRITE = 0x02

GPS_TEMPORARY

typedef v1_enum GPS_TEMPORARY = 0x04

PCUSERIALIZEDPROPSTORAGE

typedef const SERIALIZEDPROPSTORAGE UNALIGNED * PCUSERIALIZEDPROPSTORAGE

Definition at line 737 of file propsys.idl.

PDEF_INFULLTEXTQUERY

typedef v1_enum PDEF_INFULLTEXTQUERY

PDEF_NONSYSTEM

typedef v1_enum PDEF_NONSYSTEM

PDEF_QUERYABLE

typedef v1_enum PDEF_QUERYABLE

PDEF_SYSTEM

typedef v1_enum PDEF_SYSTEM

PDEF_VIEWABLE

typedef v1_enum PDEF_VIEWABLE

PERSIST_SPROPSTORE_FLAGS

typedef int PERSIST_SPROPSTORE_FLAGS

Definition at line 731 of file propsys.idl.

PKA_APPEND

typedef v1_enum PKA_APPEND

PKA_FLAGS

typedef v1_enum PKA_FLAGS

PROPDESC_ENUMFILTER

typedef v1_enum PROPDESC_ENUMFILTER

PUSERIALIZEDPROPSTORAGE

typedef SERIALIZEDPROPSTORAGE UNALIGNED * PUSERIALIZEDPROPSTORAGE

Definition at line 736 of file propsys.idl.

REFPROPERTYKEY

typedef PROPERTYKEY* REFPROPERTYKEY

Definition at line 40 of file propsys.idl.

SERIALIZEDPROPSTORAGE

typedef struct tagSERIALIZEDROPSTORAGE SERIALIZEDPROPSTORAGE

Definition at line 733 of file propsys.idl.

Enumeration Type Documentation

_PERSIST_SPROPSTORE_FLAGS

enum _PERSIST_SPROPSTORE_FLAGS

Enumerator
FPSPS_DEFAULT
FPSPS_READONLY

Definition at line 726 of file propsys.idl.

{
    FPSPS_DEFAULT = 0,
    FPSPS_READONLY = 1
};

Function Documentation

DEFINE_ENUM_FLAG_OPERATORS()

DEFINE_ENUM_FLAG_OPERATORS

(

GETPROPERTYSTOREFLAGS

)

PSCreateMemoryPropertyStore()

PSSTDAPI PSCreateMemoryPropertyStore	(	REFIID	riid,
		void **	ppv
	)

Definition at line 471 of file propsys_main.c.

{
    TRACE("(%s, %p)\n", debugstr_guid(riid), ppv);
 
    return PropertyStore_CreateInstance(NULL, riid, ppv);
}

Referenced by test_propertystore(), test_PSCreateMemoryPropertyStore(), and test_PSCreatePropertyStoreFromObject().

PSCreatePropertyStoreFromObject()

PSSTDAPI PSCreatePropertyStoreFromObject	(	IUnknown *	obj,
		DWORD	access,
		REFIID	riid,
		void **	ret
	)

Definition at line 481 of file propstore.c.

{
    HRESULT hr;
 
    TRACE("(%p, %ld, %s, %p)\n", obj, access, debugstr_guid(riid), ret);
 
    if (!obj || !ret)
        return E_POINTER;
 
    if (IsEqualIID(riid, &IID_IPropertyStore) && SUCCEEDED(hr = IUnknown_QueryInterface(obj, riid, ret)))
        return hr;
 
    FIXME("Unimplemented for %s.\n", debugstr_guid(riid));
    return E_NOTIMPL;
}

Referenced by test_PSCreatePropertyStoreFromObject().

PSGetPropertyDescription()

PSSTDAPI PSGetPropertyDescription	(	REFPROPERTYKEY	propkey,
		REFIID	riid,
		void **	ppv
	)

Definition at line 223 of file propsys_main.c.

{
    FIXME("%p, %p, %p\n", propkey, riid, ppv);
    return E_NOTIMPL;
}

Referenced by propsys_GetPropertyDescription().

PSGetPropertyDescriptionListFromString()

PSSTDAPI PSGetPropertyDescriptionListFromString	(	LPCWSTR	proplist,
		REFIID	riid,
		void **	ppv
	)

Definition at line 229 of file propsys_main.c.

{
    FIXME("%s, %p, %p\n", debugstr_w(proplist), riid, ppv);
    return E_NOTIMPL;
}

Referenced by propsys_GetPropertyDescriptionListFromString().

PSPropertyKeyFromString()

PSSTDAPI PSPropertyKeyFromString	(	LPCWSTR	pszString,
		PROPERTYKEY *	pkey
	)

Definition at line 389 of file propsys_main.c.

{
    BOOL has_minus = FALSE, has_comma = FALSE;
 
    TRACE("(%s, %p)\n", debugstr_w(pszString), pkey);
 
    if (!pszString || !pkey)
        return E_POINTER;
 
    memset(pkey, 0, sizeof(PROPERTYKEY));
 
    if (!string_to_guid(pszString, &pkey->fmtid))
        return E_INVALIDARG;
 
    pszString += GUIDSTRING_MAX - 1;
 
    if (!*pszString)
        return E_INVALIDARG;
 
    /* Only the space seems to be recognized as whitespace. The comma is only
     * recognized once and processing terminates if another comma is found. */
    while (*pszString == ' ' || *pszString == ',')
    {
        if (*pszString == ',')
        {
            if (has_comma)
                return S_OK;
            else
                has_comma = TRUE;
        }
        pszString++;
    }
 
    if (!*pszString)
        return E_INVALIDARG;
 
    /* Only two minus signs are recognized if no comma is detected. The first
     * sign is ignored, and the second is interpreted. If a comma is detected
     * before the minus sign, then only one minus sign counts, and property ID
     * interpretation begins with the next character. */
    if (has_comma)
    {
        if (*pszString == '-')
        {
            has_minus = TRUE;
            pszString++;
        }
    }
    else
    {
        if (*pszString == '-')
            pszString++;
 
        /* Skip any intermediate spaces after the first minus sign. */
        while (*pszString == ' ')
            pszString++;
 
        if (*pszString == '-')
        {
            has_minus = TRUE;
            pszString++;
        }
 
        /* Skip any remaining spaces after minus sign. */
        while (*pszString == ' ')
            pszString++;
    }
 
    /* Overflow is not checked. */
    while ('0' <= *pszString && *pszString <= '9')
    {
        pkey->pid *= 10;
        pkey->pid += (*pszString - '0');
        pszString++;
    }
 
    if (has_minus)
        pkey->pid = ~pkey->pid + 1;
 
    return S_OK;
}

Referenced by test_PSPropertyKeyFromString().

PSRefreshPropertySchema()

PSSTDAPI PSRefreshPropertySchema

(

void

)

Definition at line 241 of file propsys_main.c.

{
    FIXME("\n");
    return S_OK;
}

Referenced by propsys_RefreshPropertySchema(), and test_PSRefreshPropertySchema().

PSRegisterPropertySchema()

PSSTDAPI PSRegisterPropertySchema

(

LPCWSTR

)

PSStringFromPropertyKey()

PSSTDAPI PSStringFromPropertyKey	(	REFPROPERTYKEY	pkey,
		LPWSTR	psz,
		UINT	cch
	)

Definition at line 247 of file propsys_main.c.

{
    WCHAR pidW[PKEY_PIDSTR_MAX + 1];
    LPWSTR p = psz;
    int len;
 
    TRACE("(%p, %p, %u)\n", pkey, psz, cch);
 
    if (!psz)
        return E_POINTER;
 
    /* GUIDSTRING_MAX accounts for null terminator, +1 for space character. */
    if (cch <= GUIDSTRING_MAX + 1)
        return E_NOT_SUFFICIENT_BUFFER;
 
    if (!pkey)
    {
        psz[0] = '\0';
        return E_NOT_SUFFICIENT_BUFFER;
    }
 
    swprintf(psz, cch, L"{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}", pkey->fmtid.Data1,
             pkey->fmtid.Data2, pkey->fmtid.Data3, pkey->fmtid.Data4[0], pkey->fmtid.Data4[1],
             pkey->fmtid.Data4[2], pkey->fmtid.Data4[3], pkey->fmtid.Data4[4],
             pkey->fmtid.Data4[5], pkey->fmtid.Data4[6], pkey->fmtid.Data4[7]);
 
    /* Overwrite the null terminator with the space character. */
    p += GUIDSTRING_MAX - 1;
    *p++ = ' ';
    cch -= GUIDSTRING_MAX - 1 + 1;
 
    len = swprintf(pidW, ARRAY_SIZE(pidW), L"%u", pkey->pid);
 
    if (cch >= len + 1)
    {
        lstrcpyW(p, pidW);
        return S_OK;
    }
    else
    {
        WCHAR *ptr = pidW + len - 1;
 
        psz[0] = '\0';
        *p++ = '\0';
        cch--;
 
        /* Replicate a quirk of the native implementation where the contents
         * of the property ID string are written backwards to the output
         * buffer, skipping the rightmost digit. */
        if (cch)
        {
            ptr--;
            while (cch--)
                *p++ = *ptr--;
        }
 
        return E_NOT_SUFFICIENT_BUFFER;
    }
}

Referenced by test_PSStringFromPropertyKey().

PSUnregisterPropertySchema()

PSSTDAPI PSUnregisterPropertySchema

(

LPCWSTR

)