2.2.12.2 RopGetPropertyIdsFromNames ROP Response Buffer

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

PropertyIdCount (2 bytes):  An integer that specifies the number of property IDs contained in the PropertyIds field. The value of this field MUST be equal to the value of the PropertyNameCount field of the ROP request buffer unless the value of the PropertyNameCount field is zero. In that case, the value MUST be equal to the total number of registered named properties.

PropertyIds (variable):  An array of 16-bit integers. Each integer is a property ID that is mapped from a named property that is specified in the PropertyNames field of the ROP request buffer. If a named property cannot be mapped, the associated entry in the PropertyIds field MUST be 0x0000. The order of property IDs in this array MUST match the order of the named properties specified in the PropertyNames field of the ROP request buffer.

Reasons a name couldn't be mapped include:

  • Use of the PS_MAPI namespace and not specifying 0x00 for the Kind field of the PropertyName structure ([MS-OXCDATA] section 2.6.1).

  • The name wasn't found in the mapping table and the Flags field of the ROP request buffer was not set to 0x02.

  • The user does not have permission to register new named properties.

  • The user has reached an artificial quota of named properties imposed by the server.

  • The user has reached the hard limit of 32,767 registered named properties.