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.