2.4.2 Property Error Codes
Property errors appear in two different contexts. When an error occurs in getting a property of an object, or a column of a table, from the server, then the type of the returned property value is ErrorCode (0x000A) and the property value itself is the error code. When an error occurs in setting a property of an object on the server, the RopSetProperties ROP ([MS-OXCROPS] section 2.2.8.6) returns an array of PropertyProblem structures, as specified in section 2.7, that includes the error code.
Most property error codes are also used as general error codes, but they have a special meaning in the context of a property operation.
Property error codes are presented in the following table.
|
Error code name |
Description (alternate names) |
Numeric value (hex) |
|---|---|---|
|
NotEnoughMemory |
On get, indicates that the property or column value is too large to be retrieved by the request, and the property value needs to be accessed with the RopOpenStream ROP ([MS-OXCROPS] section 2.2.9.1). (E_NOMEMORY, MAPI_E_NOT_ENOUGH_MEMORY) |
0x8007000E, %x0E.00.07.80 |
|
NotFound |
On get, indicates that the property or column has no value for this object. (MAPI_E_NOT_FOUND) |
0x8004010F, %x0F.01.04.80 |
|
BadValue |
On set, indicates that the property value is not acceptable to the server. (MAPI_E_BAD_VALUE, ecPropBadValue) |
0x80040301, %x01.03.04.80 |
|
InvalidType |
On get or set, indicates that the data type passed with the property or column is undefined. (MAPI_E_INVALID_TYPE, ecInvalidType) |
0x80040302, %x02.03.04.80 |
|
UnsupportedType |
On get or set, indicates that the data type passed with the property or column is not acceptable to the server. (MAPI_E_TYPE_NO_SUPPORT, ecTypeNotSupported) |
0x80040303, %x03.03.04.80 |
|
UnexpectedType |
On get or set, indicates that the data type passed with the property or column is not the type expected by the server. (MAPI_E_UNEXPECTED_TYPE, ecPropType) |
0x80040304, %x04.03.04.80 |
|
TooBig |
Indicates that the result set of the operation is too big for the server to return. (MAPI_E_TOO_BIG, ecTooBig) |
0x80040305, %x05.03.04.80 |
|
DeclineCopy |
On a copy operation, indicates that the server cannot copy the object, possibly because the source and destination are on different types of servers, and the server will delegate the copying to client code. (MAPI_E_DECLINE_COPY) |
0x80040306, %x06.03.04.80 |
|
UnexpectedId |
On get or set, indicates that the server does not support property IDs in this range, usually the named property ID range (from 0x8000 through 0xFFFF). (MAPI_E_UNEXPECTED_ID) |
0x80040307, %x07.03.04.80 |