wpclsQueryExtendedCriteria
Appearance
This class method is called to allow the specified class to specify the extended criteria to be used on a search for instances of this class.
Syntax
_wpclsQueryExtendedCriteria(somSelf, Title, ulSearchType, ExtendedCriteria)
Parameters
- somSelf (M_WPObject *) - input
- Pointer to the WPObject class object.
- Title (PSZ) - input
- Pointer to the title specification for objects to be searched. This title may include the wildcard characters '*' and '?'.
- ulSearchType (ULONG) - input
- Flag indicating type of search to be performed. SEARCH_ALL_FOLDERS Search all folders. SEARCH_THIS_FOLDER Search current folder only. SEARCH_THIS_TREE Search the current folder tree only.
- ExtendedCriteria (PVOID) - output
- Pointer to a buffer that contains the class-specific extended search criteria. This buffer can be passed to the wpDoesObjectMatch method.
- fSuccess (BOOL) - returns
- Success indicator. TRUE Successful completion. FALSE An error occurred or the user canceled the search operation.
Returns
- fSuccess (BOOL) - returns
- Success indicator. TRUE Successful completion. FALSE An error occurred or the user canceled the search operation.
Remarks
This method is called by the system during the processing of the Find and folder Include facilities. This method typically prompts the user to select the extended criteria.
How to Override
This method should be overridden by classes which introduce extended search criteria for use by the Find and folder Include facilities.
Usage
This method can be called at any time in order to determine the extended search criteria to be used for finding objects of this class.