This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

CMDBGetInstanceBLOB function

The CMDBGetInstanceBLOB function retrieves the attachment, or binary large object (BLOB ), stored for the attachment subclasses. The BLOB can be returned in a file or in an in-memory buffer.


#include "ar.h"
#include "arextern.h"
#include "cmdb.h"

int CMDBGetInstanceBLOB(
      ARControlStruct *control,
      CMDBClassNameId *classNameId,
      ARNameType datasetId,
      unsigned int getMask,
      ARNameType instanceId,
      ARNameType attributeName,
      ARLocStruct *loc,
      ARStatusList *status)

Input arguments

Input argument



The control record for the operation, which contains information about the user requesting the operation and the server on which the operation is to be performed.


The name of the class for which to retrieve the instance blob. The classNameID argument contains the namespace name and the unique class name.


The unique identifier for the dataset. The data in the return values are based on the dataset ID specified in this parameter.


The ID that specifies the type of dataset on which to perform the operation.

  • 0: None--Based on the datasetId being passed, instances are retrieved from either the overlay or the original dataset (CMDB_GET_MASK_NONE ).
  • 1<<0: Current Mode--Allows you to retrieve instances from the current dataset only (CMDB_GET_DATASET_MODE_CURRENT ).


The unique identifier of the instance to retrieve.


The name of the attribute that contains the attachment.

Return values

Return value



The location where the BLOB is stored.


A list of zero or more notes, warnings, or errors generated from a call of this function.

Was this page helpful? Yes No Submitting... Thank you