3.1.4.1 Opening a Folder

Before any data can be read from or written to a folder, the client opens the folder. The client MUST have sufficient access rights to the folder for this operation to succeed.

To open an existing folder, the client sends the RopOpenFolder ROP request ([MS-OXCROPS] section 2.2.4.1). To send this request, the client first obtains the FID ([MS-OXCDATA] section 2.2.1.1) for the Folder object to be opened. The FID can be retrieved from the hierarchy table that contains the folder's information by including the PidTagFolderId property (section 2.2.2.2.1.6) in a RopSetColumns request ([MS-OXCROPS] section 2.2.5.1.1).

The Folder object that is opened can be used in subsequent operations. When the client completes operations on the Folder object, the client MUST release the object as specified in section 3.1.5.1.