3.2.5.2.2 INtmsMediaServices1 Interface

The INtmsMediaServices1 interface is implemented by servers to support management of media. The UUID for this interface is "D02E4BE0-3419-11D1-8FB1-00A024CB6019". The version for this interface is "1.0".

INtmsMediaServices1 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

MountNtmsMedia

Mounts one or more pieces of media.

Opnum: 3

DismountNtmsMedia

Queues a command to move a medium in a drive to its storage.

Opnum: 4

Opnum5NotUsedOnWire

Reserved for local use.

Opnum: 5

AllocateNtmsMedia

Allocates a piece of available media.

Opnum: 6

DeallocateNtmsMedia

Deallocates the side associated with a piece of logical media.

Opnum: 7

SwapNtmsMedia

Swaps the position of two media sides.

Opnum: 8

DecommissionNtmsMedia

Decommissions a media side.

Opnum: 9

SetNtmsMediaComplete

Marks a piece of logical media as complete.

Opnum: 10

DeleteNtmsMedia

Deletes a physical piece of offline media by removing all references to a medium.

Opnum: 11

CreateNtmsMediaPoolA

Creates a new application media pool, with strings encoded using ASCII.

Opnum: 12

CreateNtmsMediaPoolW

Creates a new application media pool, with strings encoded using Unicode.

Opnum: 13

GetNtmsMediaPoolNameA

Retrieves a full name hierarchy of a media pool, with strings encoded using ASCII.

Opnum: 14

GetNtmsMediaPoolNameW

Retrieves a full name hierarchy of a media pool, with strings encoded using Unicode.

Opnum: 15

MoveToNtmsMediaPool

Moves a medium from its current media pool to another media pool.

Opnum: 16

DeleteNtmsMediaPool

Deletes an application media pool.

Opnum: 17

AddNtmsMediaType

Adds a media type to a library if there is not currently a relation in the library.

Opnum: 18

DeleteNtmsMediaType

Deletes a media type from a library.

Opnum: 19

ChangeNtmsMediaType

Moves a physical media identifier to a new media pool, and sets the media type of the medium to that of the pool.

Opnum: 20

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

All methods MUST NOT throw exceptions.