Share via

2.2.1.14.1 RopGetContentsTable ROP Request Buffer

  • Article

The following descriptions define valid fields for the RopGetContentsTable ROP request buffer ([MS-OXCROPS] section 2.2.4.14.1).

InputHandleIndex (1 byte):  An integer that specifies the location in the Server object handle table where the handle for the input Server object is stored. The input Server object for this operation is a Folder object that represents the folder whose contents table will be retrieved.

OutputHandleIndex (1 byte):  An integer that specifies the location in the Server object handle table where the handle for the output Server object is stored. The output Server object for this operation is a Table object that represents the contents table. For more details about Table objects, see [MS-OXCTABL].

TableFlags (1 byte):  A set of bits that control how information is returned in the contents table.

The bits that SHOULD<8> be valid for this field are specified in the following table. The client MUST NOT set any other bits.

Bit name

Value

Meaning

Associated

0x02

If this bit is set, the contents table lists only the FAI messages. If this bit is not set, the contents table lists only the non-FAI messages. For details about FAI messages, see [MS-OXCMSG] section 1.3.2.

DeferredErrors

0x08

The ROP response is returned immediately, possibly before the ROP execution is complete, and in this case, the values of the ReturnValue and the RowCount fields of the ROP response buffer might not be accurate.

NoNotifications

0x10

The contents table notifications to the client are disabled. Table notifications are specified in [MS-OXCNOTIF] section 2.2.1.1.1.

SoftDeletes

0x20

If this bit is set, the contents table lists only the messages that are soft deleted. If this bit is not set, the contents table lists only the existing messages.

The listing of soft-deleted messages in a folder's contents table depends on whether the soft-deleted messages remain part of that folder's contents. The location where soft-deleted messages are stored is up to the implementer of the protocol.

UseUnicode

0x40

If this bit is set, the columns that contain string data are returned in Unicode format. If this bit is not set, the string data is encoded in the code page of the Logon object.

ConversationMembers

0x80

The contents table lists messages pertaining to a single conversation (one result row represents a single message). This bit is valid only in conjunction with the UseUnicode bit and the DeferredErrors bit; This bit is supported only on the Root folder of a mailbox and on public folders.