2.2.1.12.1 RopReadPerUserInformation ROP Request Buffer

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

FolderId: Contains a LongTermID structure ([MS-OXCDATA] section 2.2.1.3.1) that specifies the folder to query.

Reserved: This field MUST be set to 0x00 and is ignored by the server.

DataOffset: Identifies the offset into the stream of data. This value is the position of the first byte of data to be returned. The value MUST be greater than or equal to zero.

The client MUST NOT set DataOffset to an arbitrary value. The value MUST be zero in the first RopReadPerUserInformation request ([MS-OXCROPS] section 2.2.3.12.1). If subsequent requests are necessary to retrieve all the data, then the client MUST update DataOffset by adding to it the value of the DataSize field of the previous RopReadPerUserInformation response ([MS-OXCROPS] section 2.2.3.12.2). In other words, if HasFinished equals FALSE, then DataOffset MUST be updated, as follows, after each RopReadPerUserInformation response.

    DataOffset = DataOffset + DataSize

MaxDataSize: Specifies the maximum amount of data to be returned to the client in a single RopReadPerUserInformation response ([MS-OXCROPS] section 2.2.3.12.2). The client can set MaxDataSize to zero, which indicates to the server that a default value MUST be used as the maximum size. When multiple RopReadPerUserInformation requests ([MS-OXCROPS] section 2.2.3.12.1) are necessary to retrieve all of the data, the client can set MaxDataSize to a different value in each invocation of the ROP.