PD_5_RW 0x0000003f Optical disk - Phase change dual rewritable ABL_5_WO 0x00000040 Optical disk - Ablative 5.25 inch write once optical PINNACLE_APEX_5_RW 0x00000041 Optical disk - Pinnacle Apex 4.6GB rewritable optical SONY_12_WO 0x00000042 Optical disk - Sony 12 inch write once PHILIPS_12_WO 0x00000043 Optical disk - Philips/LMS 12 inch write once HITACHI_12_WO 0x00000044 Optical disk - Hitachi 12 inch once CYGNET_12_WO 0x00000045 Optical disk - Cygnet/ATG 12 inch write once KODAK_14_WO 0x00000046 Optical disk - Kodak 14 inch write once MO_NFR_525 0x00000047 Optical disk - Near field recording (Terastor) NIKON_12_RW 0x00000048 Optical disk - Nikon 12 inch rewritable IOMEGA_ZIP 0x00000049 Magnetic disk - Iomega Zip IOMEGA_JAZ 0x0000004a Magnetic disk - Iomega Jaz SYQUEST_EZ135 0x0000004b Magnetic disk - Syquest SYQUEST_EZFLYER 0x0000004c Magnetic disk - Syquest EzFlyer SYQUEST_SYJET 0x0000004d Magnetic disk - Syquest SyJet AVATAR_F2 0x0000004e Magnetic disk - 2.5 inch floppy MP2_8mm 0x0000004f Tape - 8 millimeter Hitachi tape DST_S 0x00000050 Ampex DST small tapes DST_M 0x00000051 DST medium tapes
0x00000052 DST large tapes VXATape_1 0x00000053 8 millimeter tape VXATape_2 0x00000054 Ecrix 8 millimeter tape STK_9840 0x00000055 STK 9840 LTO_Ultrium 0x00000056 IBM, HP, Seagate LTO Ultrium LTO_Accelis 0x00000057 IBM, HP, Seagate LTO Accelis DVD_RAM 0x00000058 Optical disk - DVD-RAM AIT_8mm 0x00000059 AIT2 or higher ADR_1 0x0000005a OnStream ADR Mediatypes ADR_2 0x0000005b OnStream ADR Mediatypes STK_9940 0x0000005c STK 9940 SAIT 0x0000005d SAIT tapes NumberOfSides: The number of sides on the media. ReadWriteCharacteristics: Identifies the read/write characteristics of the media type. This MUST be one of the following values. Value Meaning NTMS_MEDIARW_UNKNOWN 0x00000000 Unknown characteristics. This value can be used to initialize ReadWriteCharacteristics before a final value is assigned. NTMS_MEDIARW_REWRITABLE 0x00000001 Media that can be written to more than once. This includes magnetic tape, magnetic disk, and some optical disk media. NTMS_MEDIARW_WRITEONCE 0x00000002 Media that can be written to only one time. Some optical media (for example, 5.25-inch, 12-inch, 14-inch WORM, and CD-R) are designed to be write-once. NTMS_MEDIARW_READONLY 0x00000003 Media that cannot be written to, such as a CD-ROM and a DVD-ROM.
dwLibRequestPurgeTime: The number of seconds that the completed library requests are maintained in the work queue.<15> dwOpRequestPurgeTime: The total number of seconds that the completed operator requests are maintained in the operator request queue.<16> dwLibRequestFlags: The library request options. This member contains the following flag fields. 0 1 2 3 4 5 6 7 8 9 1 0 1 2 3 4 5 6 7 8 9 2 0 1 2 3 4 5 6 7 8 9 3 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 F A Where the bits are defined as: Value Description A NTMS_LIBREQFLAGS_NOAUTOPURGE Library requests are not purged from the work queue. This MUST be set to NULL by default. F NTMS_LIBREQFLAGS_NOFAILEDPURGE Failed work items are not purged from the work queue. This MUST be set to NULL by default. dwOpRequestFlags: The operator request options. Possible values include the following. Meaning NTMS_OPREQFLAGS_NOAUTOPURGE 0x01 Operator requests MUST NOT be purged from the work This MUST be set to NULL by default. NTMS_OPREQFLAGS_NOFAILEDPURGE 0x02 Failed operator requests MUST NOT be purged from the queue. This MUST be set to NULL by default. NTMS_OPREQFLAGS_NOALERTS 0x10 The for operator requests MUST be disabled. NTMS_OPREQFLAGS_NOTRAYICON 0x20 The taskbar icon for operator requests MUST be disabled. dwMediaPoolPolicy: Media pool policies. Possible values include the following. Value Meaning NTMS_POOLPOLICY_PURGEOFFLINESCRATCH 0x01 Any free that is ejected MUST be automatically deleted. This MUST be set to NULL by default. NTMS_POOLPOLICY_KEEPOFFLINEIMPORT 0x02 Any import media that is ejected MUST NOT be deleted automatically. This MUST be set to NULL by default. NTMS_OPREQUESTINFORMATIONA Structure The NTMS_OPREQUESTINFORMATIONA structure describes the properties of an operator request, in ASCII.
HRESULT InventoryNtmsLibrary( [in] LPNTMS_GUID lpLibraryId, [in] DWORD dwAction ); lpLibraryId: A pointer to the identifier of a library. dwAction: One of the NTMS_INVENTORY_STOP, NTMS_INVENTORY_OMID, NTMS_INVENTORY_FAST, or NTMS_INVENTORY_DEFAULT values from the enumeration, specifying the action to perform. Return value/code Description 0x00000000 S_OK The call was successful. 0x80070005 ERROR_ACCESS_DENIED Access to the object was denied. 0x80070057 ERROR_INVALID_PARAMETER A parameter is not valid. 0x800708CA ERROR_NOT_CONNECTED Unable to connect to the server. 0x800710D1 ERROR_LIBRARY_OFFLINE The library identifier refers to an offline library. 0x800710D5 ERROR_RESOURCE_DISABLED A resource required for this operation is disabled. 0x800710CD ERROR_INVALID_LIBRARY The library identifier is invalid. Upon receiving this message, the server MUST verify that lpLibraryId is not NULL. If parameter validation fails, the server MUST immediately fail the operation and return ERROR_INVALID_PARAMETER (0x80070057). If parameter validation succeeds, the server MUST get the library selected from the database, check the access to the library, and verify that the library is enabled and is online before making the call. If the client does not have the required access rights, the server MUST return ERROR_ACCESS_DENIED. If the library is disabled, the server MUST return ERROR_RESOURCE_DISABLED (0x800710D5). If the library is offline, the server MUST return ERROR_LIBRARY_OFFLINE (0x800710D1). The action taken by the server depends on the value of dwAction. The following table lists all possible values for dwAction. Meaning NTMS_INVENTORY_OMID A full inventory is performed. Each side of each medium MUST be
0x800708CA ERROR_NOT_CONNECTED Unable to connect to the server. 0x800710CD ERROR_INVALID_LIBRARY The library identifier is invalid. 0x800710DF ERROR_DEVICE_NOT_AVAILABLE The library is not connected. 0x800710EB ERROR_CLEANER_SLOT_SET A cleaner slot is already reserved. 0x8007138E ERROR_RESOURCE_NOT_AVAILABLE The specified slot already contains a medium. Upon receiving this message, the server MUST verify that both lpLibrary and lpSlot are not NULL. If parameter validation fails, the server MUST immediately fail the operation and return ERROR_INVALID_PARAMETER (0x80070057). If parameter validation succeeds, the server MUST check access rights to the library and verify that the library is enabled and online before further processing. If the client does not have the required access rights, the server MUST return ERROR_ACCESS_DENIED (0x80070005). If the specified slot is not present, the server MUST return ERROR_RESOURCE_NOT_AVAILABLE (0x8007138E). If the library is offline, the server MUST return ERROR_LIBRARY_OFFLINE (0x800710D1). Only a single slot in a library can be reserved for a cleaner cartridge. If the library already has a cleaner slot reserved, the server MUST return ERROR_CLEANER_SLOT_SET (0x800710EB). Return value/code Description 0x00000000 S_OK The call was successful. 0x80070005 ERROR_ACCESS_DENIED Access to at least one object is denied. 0x80070006 ERROR_INVALID_HANDLE The session handle is invalid. 0x80070008 ERROR_NOT_ENOUGH_MEMORY Not enough storage is available to process this command. 0x80070057 ERROR_INVALID_PARAMETER The parameter is incorrect. 0x800701E7 ERROR_INVALID_ADDRESS An attempt was made to access an invalid address. 0x800708CA ERROR_NOT_CONNECTED Unable to connect to the server. 0x800710CD ERROR_INVALID_LIBRARY The library identifier is invalid.
0x00000002 NTMS_OPREQ_DEVICESERVICE 0x00000003 MUST be set to a pointer to the identifier of the device that needs service. NTMS_OPREQ_MOVEMEDIA 0x00000004 MUST be set to a pointer to the identifier of the piece of physical media to move. NTMS_OPREQ_MESSAGE 0x00000005 MUST be set to NULL. lpArg2Id: This parameter MUST be set according to the of dwRequest. of dwRequest lpArg2Id NTMS_OPREQ_NEWMEDIA 0x00000001 MUST be set to a pointer to the identifier of the media library to which the new media MUST be added. NTMS_OPREQ_CLEANER 0x00000002 MUST be set to NULL. NTMS_OPREQ_DEVICESERVICE 0x00000003 MUST be set to NULL. NTMS_OPREQ_MOVEMEDIA 0x00000004 MUST be set to a pointer to the identifier of the target library to which the media MUST be moved. NTMS_OPREQ_MESSAGE 0x00000005 MUST be set to NULL. lpRequestId: A pointer to the identifier of the created operator request. Return value/code Description 0x00000000 S_OK The call was successful. 0x80070005 ERROR_ACCESS_DENIED Access to one or more objects is denied. 0x80070057 ERROR_INVALID_PARAMETER An invalid parameter was 0x800708CA ERROR_NOT_CONNECTED Unable to connect to the service. 0x800710D8 ERROR_OBJECT_NOT_FOUND Unable to find the source or destination object. 0x800710D9 ERROR_DATABASE_FAILURE The database query or update failed. The SubmitNtmsOperatorRequestW method submits an operator request, and returns the status of the request (Satisfied or Canceled), or times out (if the operator does not act upon the request). Operator
M M M M M M M M U U C C M C NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT NTMS_LIBRARY NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT U U U U U U U U U U U U U U U U NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT NTMS_LIBRARY U U U U U U U U
NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT U U U U U U U U INtmsObjectManagement1::GetNtmsObjectSecurity NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT NTMS_LIBRARY NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT R R R R R R R R R R R R R R R C INtmsObjectManagement2::GetNtmsUIOptionsA INtmsObjectManagement2::GetNtmsUIOptionsW NTMS_COMPUTER NTMS_LIBRARY U U C C C C U U C U C C C
C NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT NTMS_LIBRARY NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT U U U U U U U U U U U U U U U U NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT NTMS_LIBRARY NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT M M M M M M M M C M M M M M M M INtmsObjectManagement1::SetNtmsObjectSecurity NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT W W W W W W W
NTMS_LIBRARY NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT W W W W W W W W W INtmsLibraryControl1::SetNtmsRequestOrder C NTMS_OPREQ_CLEANER NTMS_OPREQ_DEVICESERVICE NTMS_OPREQ_MESSAGE NTMS_OPREQ_MOVEMEDIA NTMS_OPREQ_NEWMEDIA C C C C U NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT NTMS_LIBRARY NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT U U U U U U U U U U U U U U U U NTMS_COMPUTER NTMS_LIBRARY U&M U&M M In Windows 2000 or Windows XP, the following table identifies the RSM methods and their security requirements. Method Media Pool Library Computer
INtmsLibraryControl1::InjectNtmsMedia C INtmsLibraryControl1::InventoryNtmsLibrary C INtmsMediaServices1::MountNtmsMedia U U INtmsMediaServices1::MoveToNtmsMediaPool M INtmsSession1::OpenNtmsServerSessionA INtmsSession1::OpenNtmsServerSessionW U INtmsLibraryControl1::ReleaseNtmsCleanerSlot C INtmsLibraryControl1::ReserveNtmsCleanerSlot C INtmsSession1::SatisfyNtmsOperatorRequest C INtmsMediaServices1::SetNtmsMediaComplete M INtmsObjectManagement1::SetNtmsObjectInformationA INtmsObjectManagement1::SetNtmsObjectInformationW NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_PARTITION NTMS_STORAGESLOT C C C C INtmsObjectManagement1::SetNtmsObjectSecurity NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT NTMS_LIBRARY NTMS_LIBREQUEST NTMS_LOGICAL_MEDIA NTMS_MEDIA_POOL NTMS_MEDIA_TYPE NTMS_OPREQUEST NTMS_PARTITION NTMS_PHYSICAL_MEDIA NTMS_STORAGESLOT W W W W W W W W W W W W W W W W INtmsObjectManagement2::EnumerateNtmsObjectR NTMS_CHANGER NTMS_CHANGER_TYPE NTMS_COMPUTER NTMS_DRIVE NTMS_DRIVE_TYPE NTMS_IEDOOR NTMS_IEPORT U U U U U U U
Index A Abstract data model 63 67 75 150 111 97 13 B 90 C 80 148 13 210 113 76 Client 63 64 63 67 64 64 67 63 143 16 16 66 122 104 106 125 D Data model - abstract 63 67 16 99 101 86 85 103 110 112 89 138 77 96 151 E 84 72 139 92 137 154 169 150 F 15 175 G 107 164 108 165 131 160 133 162 129 87 115 116 155 156 9 H Higher-layer triggered events 64 70 I 152 175 61 61 174 149 174 12 Initialization 63 69 82 73 22 24 24 27 27 61 61 9 78
L Local events 67 168 26 27 27 47 49 62 26 M Message processing 64 70 65 Messages 16 61 24 27 61 16 16 16 93 109 N 12 26 27 33 34 34 35 53 35 36 37 38 52 52 19 39 40 53 42 43 27 47 49 54 56 57 58 59 60 51 22 24 29 25 19 29 22 23 23 30 19 31 25 25 18 17 31 18 32 61 61 O OnNotify method ( 65, 66) 142 141 12 P 174 13 13 196 Protocol Details 63 R 167 11 12 12 13 67 82 151 80 62 S 148 Security 174 174 174 26 166 Sequencing rules 64 70 Server 67