IABTable::Restrict


		Contents Index Topic Contents
	Previous Topic: IABTable::QuerySortOrder Next Topic: IABTable::SeekRow

IABTable::Restrict
HRESULT Restrict(
    lpRestriction,
    ulFlags
);
Applies a restriction to a table, reducing the rows visible to only those matching the restriction criteria.
Returns one of the following values:

S_OK The filter was successfully applied.

MAPI_E_BUSY Another operation is in progress that prevents the restriction operation from starting. Either the operation in progress should be allowed to complete, or it should be stopped.

MAPI_E_TOO_COMPLEX The table cannot perform the operation because the particular filter pointed to by the lpRestriction parameter is too complicated.

lpRestriction
Address of an SRestriction structure defining the conditions of the restriction. Passing NULL removes the current restriction.
ulFlags
Flags specifying asynchronous operation. For Internet Explorer Address Book, this value must be zero.

Back to top

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

S_OK	The filter was successfully applied.
MAPI_E_BUSY	Another operation is in progress that prevents the restriction operation from starting. Either the operation in progress should be allowed to complete, or it should be stopped.
MAPI_E_TOO_COMPLEX	The table cannot perform the operation because the particular filter pointed to by the lpRestriction parameter is too complicated.