IMAPITable::Restrict Method

  • Article

Applies a restriction to a table, reducing the visible rows to those matching the restriction criteria.

Syntax

HRESULT Restrict(
    SRestriction *lpRestriction,
    ULONG ulFlags
);

Parameters

  • lpRestriction
    SRestriction Pointer to a variable of type SRestriction that specifies the conditions of the restriction. Passing NULL removes the current restriction.
  • ulFlags
    ULONG Reserved. Must be set to 0.

Return Value

HRESULT

The method can return one of the following values.

Return code Description
S_OK

The operation completed successfully.
MAPI_E_BUSY

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

The table cannot perform the operation because the specified criteria are too complicated.

 

Remarks

If the filter specified by the lpRestriction parameter is too complicated, the method returns MAPI_E_TOO_COMPLEX.

Requirements

Minimum supported client

 Windows 2000 Professional

Minimum supported server

 Windows 2000 Server

Product

 Internet Explorer 4.0

Header

 Wabdefs.h

DLL

 Wab32.dll

See Also

IMAPITable

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010