DMA Return Codes
All DMA methods return an integer return code following the conventions used for an HRESULT in the COM specification. This table lists symbolic names and descriptions for the DMA return codes, all of which start with "DMARC_".
For background on HRESULT, see http://www.microsoft.com/oledev/olecom/Ch03.htm#IUnknown
Return code listings in the method descriptions are only partial. Other generic codes (such as DMARC_FAILED) can occur. Some codes are warnings instead of errors – the descriptions of these warning codes begin with "(Warning)".
|
Name |
Description |
|
DMARC_3VE_NOT_SUPPORTED |
The current scope does not support three valued elimination. |
|
DMARC_ABORT |
The progress callback indicated that the method should be aborted. |
|
DMARC_ACCESS_DENIED |
(E_ACCESSDENIED) The requester has insufficient access rights to perform the requested operation. |
|
DMARC_ALIAS_CONFLICT |
A class, operator or property in one component scope unifies with more than one such entity in another component scope. |
|
DMARC_ALREADY_AUTHENTICATED |
The user is already authenticated. |
|
DMARC_AT_ENUM_END |
The enumerator object is positioned at the end of the component objects. |
|
DMARC_BAD_CLASSID |
The supplied identifier does not reference an available class of object. |
|
DMARC_BAD_COLLATION_SEQUENCE |
The specified collation sequence is not known or supported by the scope. |
|
DMARC_BAD_DOC_SPACE |
There is no available document space with the specified DmaId |
|
DMARC_BAD_FROM_EXPRESSION |
The query contains an invalid From Expression. |
|
DMARC_BAD_INDEX |
The index specified does not reference a valid property or list element. |
|
DMARC_BAD_INTERFACE |
(E_NOINTERFACE) The requested interface is not supported by this object. |
|
DMARC_BAD_LOCK_TYPE |
The lock type is invalid. |
|
DMARC_BAD_OBJECT |
An inappropriate object was passed as parameter to this function. For example, the object does not support a required interface or is of an inappropriate class. |
|
DMARC_BAD_OIID |
The supplied buffer does not contain a valid OIID. |
|
DMARC_BAD_OPERAND |
An operand is incorrect in datatype, form, or class. |
|
DMARC_BAD_OPERATOR |
An operator ID is not defined in the metadata of the current scope. |
|
DMARC_BAD_ORDERBY_ELEMENT |
Illegal 'order by' list element. |
|
DMARC_BAD_PARAMETER |
(E_INVALIDARG) Invalid input parameter. |
|
DMARC_BAD_PROPID |
A property identifier is not valid. |
|
DMARC_BAD_PROTECTION_LEVEL |
Illegal value for the protection level parameter. |
|
DMARC_BAD_RC |
Invalid Result Code. |
|
DMARC_BAD_REFERENCE |
The object cannot be saved because it references another object which is not persistent. |
|
DMARC_BAD_RESERVATION |
One or more of the Reservations is not the current reservation in the VersionSeries to which it refers. |
|
DMARC_BAD_SC_OCCUR |
The value of a query node's searchable class occurrence property is not present in the query. |
|
DMARC_BAD_SELECT_ELEMENT |
Illegal select list element. |
|
DMARC_BAD_SUBQUERY_DATATYPE |
The datatype of the query root node of an "IN" subquery does not match that of the property in the select list. |
|
DMARC_BAD_SUBQUERY_SELECT |
The select list of a subquery contains an inappropriate number of elements |
|
DMARC_BAD_URL |
The resource URL is not syntactically valid. |
|
DMARC_BAD_VALUE |
The value given for a property or list element lies outside the permitted range or value set, or exceeds the maximum length allowed. |
|
DMARC_CLASS_NOT_SEARCHABLE |
A class referred to in the From Expression is not searchable. |
|
DMARC_CLASSES_NOT_JOINABLE |
A particular join operator in the query is supported, but the operator does not support the join between the particular operands specified in the query. |
|
DMARC_CONFLICTING_OPERATION |
The call on this primary intentional method logically conflicts with a prior call on a different primary intentional method. |
|
DMARC_CONSTRAINT_VIOLATED |
The operation violates a constraint of the implementation. |
|
DMARC_DATATYPE_MISMATCH |
The method invoked is inappropriate for the datatype of the property. |
|
DMARC_DEVICE_ERROR |
An error has occurred reading or writing a hardware device. |
|
DMARC_DISCONNECTED |
The logical connection to the document space has been disconnected. |
|
DMARC_DISTINCT_NOT_SUPPORTED |
The scope does not support the request for distinct result rows. |
|
DMARC_EXTRA_OPERANDS |
A query node has extra operands. |
|
DMARC_FAILED |
(E_FAIL) The operation failed. |
|
DMARC_FOREIGN_OBJECT |
An object is not from the current document space. |
|
DMARC_ILLEGAL_OPERATION |
The operation is disallowed by the DMA Specification. |
|
DMARC_LIST_BOUNDS_ERROR |
The number of elements in a list is outside the permitted range. |
|
DMARC_LOST_CONNECTION |
The logical connection of the current object to the persistent store has been lost permanently. The operation could not be completed. |
|
DMARC_MAX_ROWS |
A result set was truncated because it exceeded the maximum result items parameter. |
|
DMARC_MISSING_OPERANDS |
A query node is missing one or more operands. |
|
DMARC_MISSING_REFERENCE |
The object cannot be saved because required reference to it is absent. For example, it may be required to be in a container and no appropriate relationship object exists. |
|
DMARC_MULTIPLE_CHECKIN_NOT_SUPPORTED |
The implementation does not support multiple different checkins on the same object (i.e., threaded versioning). |
|
DMARC_NEED_MORE_DATA |
(Warning) Indicates that more data is required to complete the browse connection operation. |
|
DMARC_NETWORK_ERROR |
A network error has occurred. It is undetermined as to whether retrying the method might succeed. The operation could not be completed. |
|
DMARC_NETWORK_UNAVAILABLE |
The network needed to perform this operation is not available. |
|
DMARC_NO_COLLATIONS |
Merged scope creation failed because there would be no supported collation sequences. |
|
DMARC_NO_CURRENT_VERSION |
The version series has no current version. |
|
DMARC_NO_MEMORY |
(E_OUTOFMEMORY) Insufficient memory to complete the operation. |
|
DMARC_NO_RESERVATION |
The Version Series is not holding a reservation at this time. |
|
DMARC_NOT_AUTHENTICATED |
The user is not authenticated. |
|
DMARC_NOT_CREATABLE |
Creation of objects of the specified class is not supported. |
|
DMARC_NOT_FOUND |
Requested item not found. |
|
DMARC_NOT_LOCKED |
The object is not locked. |
|
DMARC_NOT_PUBLISHED |
The service registry entry is not currently published. |
|
DMARC_NOT_SUPPORTED |
This method is not supported in the context of this session or object. |
|
DMARC_NOT_UNIQUE |
A uniqueness requirement has been violated. |
|
DMARC_OBJECT_DELETED |
The object has been deleted since it was retrieved. |
|
DMARC_OBJECT_LOCKED |
The lock(s) on the persistent object prohibit the attempted operation. |
|
DMARC_OBJECT_MODIFIED |
The object has been modified since it was retrieved. |
|
DMARC_OBJECT_REFERENCED |
The object cannot be deleted because it is referenced by other objects. |
|
DMARC_OK |
(S_OK) Success. |
|
DMARC_OPERAND_MERGE_CONFLICT |
The merge would create an invalid operand description. |
|
DMARC_OPERATOR_MERGE_CONFLICT |
An operator could not be merged because it has conflicting signatures in component scopes. |
|
DMARC_POSITION_NOT_ALLOWED |
The stream cannot be positioned as requested. |
|
DMARC_PROPERTY_MERGE_CONFLICT |
A property could not be merged because there is a conflict of conflicting datatype or cardinality in component scopes. |
|
DMARC_PROPERTY_NOT_ORDERABLE |
A property referred to in the query order by list is not orderable. |
|
DMARC_PROPERTY_NOT_SEARCHABLE |
A property referred to in the Query Expression is not searchable. |
|
DMARC_PROPERTY_NOT_SELECTABLE |
A property referred to in the Selections list is not selectable. |
|
DMARC_PROTECTION_LEVEL_NOT_SUPPORTED |
The desired protection level is not supported by the doc space. |
|
DMARC_QUERY_AT_END |
The query ran to successful completion without encountering any constraints on time limits, number of rows generated, or any other constraints, and there are no more result rows that satisfy the query. A result row is not returned. No more result rows will be returned unless ReExecuteQuery is executed. |
|
DMARC_QUERY_TREE_LOOP |
There is a circular reference loop or a shared node in the query. |
|
DMARC_READ_ONLY |
Method failed because an object or property is read-only. |
|
DMARC_REFERENCES_OTHERS |
The object cannot be deleted because it holds references to other objects. |
|
DMARC_REQUIRED_VALUE_ABSENT |
A required property value has not been set. |
|
DMARC_RESERVATION_EXISTS |
The version series is already holding a reservation. |
|
DMARC_RESERVATION_NOT_ALLOWED |
The condition of the version series does not permit a reservation, though no reservation is currently present. |
|
DMARC_RESERVATION_PENDING |
The connection is already holding a request for a reservation. There cannot be more than one at a time. |
|
DMARC_RESOURCE_NOT_FOUND |
The indicated resource was not found. |
|
DMARC_RESULTS_TRUNCATED |
The result set was truncated explicitly by a call on IdmaResultSet:: TerminateResults. No further rows will be returned unless ReExecuteQuery is executed. This is a failure code - no row is returned. |
|
DMARC_SHORT_READ |
(Warning) End of stream was encountered before the requested number of bytes was read. |
|
DMARC_STALE_METADATA |
The metadata in the persistent store has been changed so that it does not match the client's current copy of the metadata. |
|
DMARC_TIMEOUT |
A time limit has been exceeded. |
|
DMARC_TRUNCATED |
Result sets were truncated in different component scopes for different reasons. |
|
DMARC_UNEXPECTED |
(E_UNEXPECTED) An unexpected error occurred. |
|
DMARC_UNSUPPORTED_ORDERING |
An unacceptable value was provided for an ordering parameter. |
|
DMARC_URL_PROTOCOL_NOT_SUPPORTED |
The URL protocol specified in the reference is not supported. |
|
DMARC_VALUE_NOT_SET |
The requested property currently has no value. |