2.2.1.2.2 RopCreateFolder ROP Response Buffer

  • Article

The following descriptions define valid fields for the RopCreateFolder ROP response buffer ([MS-OXCROPS] section 2.2.4.2.2).

ReturnValue (4 bytes):  An integer that indicates the result of the operation. The server returns 0x00000000 to indicate success. For details about common error codes, see [MS-OXCDATA] section 2.4.

FolderId (8 bytes):  A Folder ID (FID) structure ([MS-OXCDATA] section 2.2.1.1) that specifies the folder that was created or opened.

IsExistingFolder (1 byte):  A Boolean value that is nonzero (TRUE) if a public folder with the name given by the DisplayName field of the request buffer (section 2.2.1.2.1) already exists.<3> The value is zero (FALSE) if a public folder with that name does not exist. This field applies only to a folder that is created in a public message store. The server sets this field to zero for a folder that is created in a private mailbox.

HasRules (1 byte):  A Boolean value that indicates whether rules are associated with the folder. If rules are associated with the folder, this field is set to a nonzero (TRUE) value; otherwise, this field is set to zero (FALSE). For details about rules, see [MS-OXORULE]. This field is present only if the IsExistingFolder field is set to a nonzero (TRUE) value.

IsGhosted (1 byte):  A Boolean value that indicates whether the server hosts an active replica of the folder. (If the folder is not an active replica, it is a ghosted folder.) If the server does not host an active replica of the folder, this field is set to a nonzero (TRUE) value; otherwise, this field is set to zero (FALSE). This field is present only if the IsExistingFolder field is set to a nonzero (TRUE) value and only for folders that are in a public message store.

ServerCount (2 bytes):  An integer that specifies the number of servers that have a replica of the folder. This field is present only if the IsGhosted field is set to a nonzero (TRUE) value.

CheapServerCount (2 bytes):  An integer that specifies the number of the cheapest, same-cost servers. These servers are listed at the beginning of the array contained in the Servers field. The value of this field MUST be less than or equal to the value of the ServerCount field and MUST be greater than zero when the value of the ServerCount field is greater than zero. This field is present only if the IsGhosted field is set to a nonzero (TRUE) value.

Servers (variable):  An array of null-terminated ASCII strings, each of which specifies a server that has a replica of the folder. The number of strings contained in this field is specified by the ServerCount field. This field is present only if the IsGhosted field is set to a nonzero (TRUE) value.