SearchForValueListItemsEx2 Method

The maximum number of results to return. By default, no more than 5,000 results are allowed. You can, however, allow more results vault-specifically by changing the value of the Value List Item Count Limit setting via the advanced vault settings:

Open M-Files Admin.
Select a server and a document vault that you want the setting to affect via the left-side tree view.
Select the Configurations node.
Expand Advanced Vault Settings and then select Configuration.
Expand the Search > Limits section and locate the Value List Item Count Limit settings.
Set the value to something larger than the default value of 5000.

Note, however, that setting this parameter value to 0 or 5000 causes the value specified in the above-mentioned setting to be used. If the setting has not been modified when the parameter value is 0 or 5000, the maximum is the default 5,000 results.

The default limit for traditional folders is a maximum of 100,000 results. In other words, if the value is set to 0 or 5000 and the advanced vault setting has not been modified, a maximum of 100,000 traditional folders are returned.

Description

Searches for value list items in the specified value list

Syntax

Visual Basic
Public Function SearchForValueListItemsEx2( _ ByVal ValueList As Long, _ ByVal SearchConditions As SearchConditions, _ Optional ByVal UpdateFromServer As Boolean = False, _ Optional ByVal RefreshTypeIfExternalValueList As MFExternalDBRefreshType = MFExternalDBRefreshTypeNone, _ Optional ByVal ReplaceCurrentUserWithCallersIdentity As Boolean = True, _ Optional ByVal PropertyDef As Long = -1, _ Optional ByVal MaxResults As Long = 5000 _ ) As ValueListItemSearchResults

Visual Basic

Public Function SearchForValueListItemsEx2( _
   ByVal ValueList As Long, _
   ByVal SearchConditions As SearchConditions, _
   Optional ByVal UpdateFromServer As Boolean = False, _
   Optional ByVal RefreshTypeIfExternalValueList As MFExternalDBRefreshType = MFExternalDBRefreshTypeNone, _
   Optional ByVal ReplaceCurrentUserWithCallersIdentity As Boolean = True, _
   Optional ByVal PropertyDef As Long = -1, _
   Optional ByVal MaxResults As Long = 5000 _
) As ValueListItemSearchResults

Parameters

ValueList

The value list the items of which to search for.

SearchConditions

The search conditions to be used.

UpdateFromServer

If this is set to "true", the search operation is always carried out on the server-side.

RefreshTypeIfExternalValueList

Value	Description
MFExternalDBRefreshTypeFull	The full refresh updates all the changes. This operation can take several minutes.
MFExternalDBRefreshTypeNone	No refresh is performed.
MFExternalDBRefreshTypeQuick	The quick refresh searches for new items and imports them to M-Files.

Specifies how, if at all, external value lists are updated for this operation.

ReplaceCurrentUserWithCallersIdentity

When using M-Files API in the client mode, the "ReplaceCurrentUserWithCallersIdentity" parameter must always be set to true.

PropertyDef

Specifies the property definition the filter of which should be applied to the list (-1 for none).

MaxResults

Open M-Files Admin.
Select a server and a document vault that you want the setting to affect via the left-side tree view.
Select the Configurations node.
Expand Advanced Vault Settings and then select Configuration.
Expand the Search > Limits section and locate the Value List Item Count Limit settings.
Set the value to something larger than the default value of 5000.