Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

This Windows Mobile structure works both as a filter definition and as a specifier for attributes of an individual item.

Syntax 

typedef struct _FINDITEMATTRIBUTES {
  DWORD 
cbStruct;
  DWORD 
grfiamMask;
	Union {
	LPTSTR 
pszFindText;
	LPTSTR 
pszTitle;
};
  LPTSTR 
pszTypeName;
  CLSID * 
prgclsidTypes;
  DWORD 
cclsidTypes;
  DWORD 
grfisScope;
  SIZE_T 
sizeItem;
  FILETIME 
ftTimeStamp;
  HICON 
hicon;
  void * 
pvCustom;
} FINDITEMATTRIBUTES;

Members

cbStruct

Size of the structure in bytes, for version checking. Set this to Sizeof(FINDITEMATTRIBUTES).

grfiamMask

Mask bits of the form FIAM_XXXX. These specify which fields of the structure are valid.

pszFindText

For a filter definition, this is the text to search for if FIAM_TEXT is set in grfiamMask.

pszTitle

For an individual item, this is the title or name of the item, if FIAM_TITLE is set.

pszTypeName

For an individual item, this is the type of the item, if FIAM_TYPENAME is set. This is not implemented as a filter.

prgclsidTypes

This member is reserved for future use; the value of this member must be set to NULL. FIAM_TYPES should not be set.

cclsidTypes

This member is reserved for future use; the value of this member must be set to 0.

grfisScope

The scope of the search if FIAM_SCOPE is set. Currently, the only implemented scopes are FIS_INTERNALMEMORY and FIS_SECONDARYSTORAGE (for memory cards).

sizeItem

For an individual item, this is the size of the item. This is not implemented as a filter.

ftTimeStamp

For an individual item, this is the time stamp of the item. This is not implemented as a filter.

hicon

For an individual item, this is the icon for the item. This is not implemented as a filter.

pvCustom

Custom data for the item.

Requirements

Header findext.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later

See Also

Reference

Shell Structures