3.2.5.2.1 INtmsLibraryControl1 Interface

The INtmsLibraryControl1 interface is implemented by the server to support management of media libraries. The UUID for this interface is "4E934F30-341A-11D1-8FB1-00A024CB6019". The version for this interface is "1.0".

INtmsLibraryControl1 inherits the IUnknown interface ([MS-DCOM] section 3.1.1.5.8). Opnums 0, 1, and 2 are IUnknown::QueryInterface, IUnknown::AddRef, and IUnknown::Release.

Methods in RPC Opnum Order

Method

Description

EjectNtmsMedia

Ejects media from the port of a library.

Opnum: 3

InjectNtmsMedia

Allows media to be inserted into the port of an online library.

Opnum: 4

AccessNtmsLibraryDoor

Unlocks the door of an online library.

Opnum: 5

CleanNtmsDrive

Queues a cleaning request for a drive.

Opnum: 6

DismountNtmsDrive

Moves a medium from a drive to its storage slot.

Opnum: 7

InventoryNtmsLibrary

Queues a request to perform an inventory of an online library.

Opnum: 8

Opnum9NotUsedOnWire

Reserved for local use.

Opnum: 9

CancelNtmsLibraryRequest

Cancels outstanding library requests.

Opnum: 10

ReserveNtmsCleanerSlot

Reserves a slot in an online library for a drive cleaner cartridge.

Opnum: 11

ReleaseNtmsCleanerSlot

Removes an existing slot reservation for a cleaner cartridge.

Opnum: 12

InjectNtmsCleaner

Allows a cleaner cartridge to be inserted into an online library unit.

Opnum: 13

EjectNtmsCleaner

Ejects the cleaner cartridge from the currently reserved cleaner slot.

Opnum: 14

DeleteNtmsLibrary

Deletes a library and all the devices in it.

Opnum: 15

DeleteNtmsDrive

Deletes a drive.

Opnum: 16

GetNtmsRequestOrder

Retrieves the order in which a request will be processed in the library queue.

Opnum: 17

SetNtmsRequestOrder

Sets the order in which a request will be processed in the library queue.

Opnum: 18

DeleteNtmsRequests

Deletes a request or a list of requests.

Opnum: 19

BeginNtmsDeviceChangeDetection

Begins a device change detection session.

Opnum: 20

SetNtmsDeviceChangeDetection

Sets one or more target devices for change detection.

Opnum: 21

EndNtmsDeviceChangeDetection

Ends device change detection for one or more target devices.

Opnum: 22

In the preceding table, the term "Reserved for local use" means that the client MUST NOT send the opnum, and the server behavior is undefined<21> because it does not affect interoperability.

All methods MUST NOT throw exceptions.