Media IDs transaction
An XBSA application can obtain the media IDs of a NetBackup image that contains one or more objects using the NBBSAGetMediaIds() call. NBBSAGetMediaIds() takes a copyId of any one of the objects in the image as a parameter. NBBSAGetMediaIds() returns a null character delimited text string that contains the media IDs associated with a NetBackup image in the buffer supplied as a parameter. The list of media IDs is terminated with an empty string. This is called a double null terminated string.
Examples are as follows:
Image with two media IDs:
MediaId1\0MediaId2\0\0Image with one media ID:
MediaId3\0\0
Within a media ID transaction, you can embed BSAQueryObject() and BSAGetNextQueryObject() calls. This lets the XBSA application intermix the media ID operations with BSAQueryObject() and BSAGetNextQueryObject() calls to obtain the media IDs for multiple images within one transaction. Backup and restore operations are not allowed within a media ID transaction.