Error Codes

All methods return an HRESULT, with the standard value of S_OK indicating success. Other success codes, such as S_FALSE, are avoided due to marshaling issues.

Some standard HRESULT values may be returned from any method and thus are not indicated in the individual method descriptions; these are listed below:

S_OK

Method succeeds.

E_INVALIDARG

Method fails with an invalid argument value.

E_NOINTERFACE

Method fails requesting an unavailable interface.

E_POINTER

Method fails with a required pointer NULL or an invalid value.

E_ACCESSDENIED

Method fails trying to access a resource with insufficient privileges.

E_NOTIMPL

Method fails and is not currently implemented.

CBS-specific error codes are defined in the CBS header file.

CBS_E_INTERNAL_ERROR

CBSERR(0x800)
Reserved for future error message.

CBS_E_NOT_INITIALIZED

CBSERR(0x801)
Method fails with an uninitialize session.

CBS_E_ALREADY_INITIALIZED

CBSERR(0x802)
Method fails with the session already initialized.

CBS_E_INVALID_PARAMETER

CBSERR(0x803)
Method fails with an invalid argument value.

CBS_E_OPEN_FAILED

CBSERR(0x804)
Method fails when locating or opening an update or package.

CBS_E_INVALID_PACKAGE

CBSERR(0x805)
Method fails with an invalid update package.

CBS_E_PENDING

CBSERR(0x806)
Method cannot complete with resources currently in use.

CBS_E_NOT_INSTALLABLE

CBSERR(0x807)
Method fails when installing component separately.

CBS_E_IMAGE_NOT_ACCESSIBLE

CBSERR(0x808)
Method fails when accessing the location of the target image.

CBS_E_ARRAY_ELEMENT_MISSING

CBSERR(0x809)
Method fails when getting missing array element.

CBS_E_REESTABLISH_SESSION

CBSERR(0x80A)
Method fails with an expired session. Recreate the session for the updated session object.

CBS_E_PROPERTY_NOT_AVAILABLE

CBSERR(0x80B)
Method fails when requesting an unavailable property.

CBS_E_UNKNOWN_UPDATE

CBSERR(0x80C)
Method fails with an update missing in the package.

CBS_E_MANIFEST_INVALID_ENTITY

CBSERR(0x80D)
Method fails with a manifest that contains an invalid attribute or element name.

CBS_E_MANIFEST_VALIDATION_DUPLICATE_ATTRIBUTES

CBSERR(0x80E)
Method fails with repeated attribute names used in manifest.

CBS_E_MANIFEST_VALIDATION_DUPLICATE_ELEMENT

CBSERR(0x80F)
Method fails with repeated element names in manifest.

CBS_E_MANIFEST_VALIDATION_MISSING_REQUIRED_ATTRIBUTES

CBSERR(0x810)
Method fails with missing manifest attributes.

CBS_E_MANIFEST_VALIDATION_MISSING_REQUIRED_ELEMENTS

CBSERR(0x811)
Method fails with missing manifest elements.

CBS_E_MANIFEST_VALIDATION_UPDATES_PARENT_MISSING

CBSERR(0x812)
Method fails with missing manifest elements.

CBS_E_INVALID_INSTALL_STATE

CBSERR(0x813)
Method fails when setting an invalid install state.

CBS_E_INVALID_CONFIG_VALUE

CBSERR(0x814)
Method fails with an invalid configuration value.