6/20/2008 4.0 Major Updated and revised the technical content. 7/25/2008 5.0 Updated and revised the technical content. 8/29/2008 6.0 Major Updated and revised the technical content. 10/24/2008 6.0.1 Editorial Changed language and formatting in the technical content. 12/5/2008 6.1 Minor Clarified the meaning of the technical content. 1/16/2009 6.2 Clarified the meaning of the technical content. 2/27/2009 6.3 Minor Clarified the meaning of the technical content. 4/10/2009 7.0 Major Updated and revised the technical content. 5/22/2009 7.0.1 Editorial Changed language and formatting in the technical content.
7/2/2009 8.0 Major Updated and revised the technical content. 8/14/2009 9.0 Major Updated and revised the technical content. 9/25/2009 10.0 Major Updated and revised the technical content. 11/6/2009 10.0.1 Editorial Changed language and formatting in the technical content. 12/18/2009 10.0.2 Editorial Changed language and formatting in the technical content. 1/29/2010 10.1 Minor Clarified the meaning of the technical content. 3/12/2010 10.1.1 Editorial Changed language and formatting in the technical content. 4/23/2010 10.1.2 Editorial Changed language and formatting in the technical content. 6/4/2010 10.1.3 Editorial Changed language and formatting in the
3/25/2011 10.1.3 None No changes to the meaning, language, or formatting of the technical content. 5/6/2011 10.1.3 None No changes to the meaning, language, or formatting of the technical content. 6/17/2011 10.2 Minor Clarified the meaning of the technical content. 9/23/2011 10.2 None No changes to the meaning, language, or formatting of the technical content. 12/16/2011 10.2 None No changes to the meaning, language, or formatting of the technical content. 3/30/2012 10.2 None No changes to the meaning, language, or formatting of the technical content. 7/12/2012 10.2 None No changes to the meaning, language, or
formatting of the technical content. 10/25/2012 10.2 None No changes to the meaning, language, or formatting of the technical content. 1/31/2013 10.2 None No changes to the meaning, language, or formatting of the technical content. 8/8/2013 10.2 None No changes to the meaning, language, or formatting of the technical content. 11/14/2013 10.2 None No changes to the meaning, language, or formatting of the technical content. 2/13/2014 10.2 None No changes to the meaning, language, or formatting of the technical content. 5/15/2014 11.0 Major Updated and revised the technical content.
ABL_5_WO 0x00000040 Optical disk - Ablative 5.25 inch 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 write 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 - 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 AVATAR_F2 0x0000004e Magnetic disk - 2.5 inch floppy MP2_8mm 0x0000004f Tape - 8 millimeter Hitachi tape DST_S 0x00000050 DST small tapes DST_M 0x00000051 DST medium tapes DST_L 0x00000052 DST large tapes
dwLibRequestPurgeTime: The total 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 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. Value Meaning NTMS_OPREQFLAGS_NOAUTOPURGE 0x01 Operator requests MUST NOT be purged from the work queue. 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 alert 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 media 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.
InventoryMethod szDescription szName MAY require NTMS_CONTROL_ACCESS to the library.<40> NTMS_LIBREQUEST szDescription MAY require NTMS_MODIFY_ACCESS to the library.<41> NTMS_LOGICAL_MEDIA szDescription szName MAY require NTMS_MODIFY_ACCESS to the media pool of the logical media.<42> NTMS_MEDIA_POOL AllocationPolicy DeallocationPolicy dwMaxAllocates MediaType szDescription szName MAY require NTMS_MODIFY_ACCESS to the media pool.<43> NTMS_MEDIA_TYPE szDescription MAY require NTMS_MODIFY_ACCESS to the computer.<44> NTMS_OPREQUEST szDescription MAY require NTMS_MODIFY_ACCESS to the computer.<45> NTMS_PARTITION szName szDescription MAY require NTMS_MODIFY_ACCESS to the pool of the side.<46> NTMS_PHYSICAL_MEDIA szDescription szName MAY require NTMS_MODIFY_ACCESS to the media pool.<47> NTMS_STORAGESLOT szDescription MAY require NTMS_MODIFY_ACCESS to the library.<48> Strings sent to this method as parameters MUST be ASCII-encoded. INtmsObjectInfo1::SetNtmsObjectInformationW (Opnum 6) The SetNtmsObjectInformationW method changes the information of an object, with strings encoded using Unicode. HRESULT SetNtmsObjectInformationW( [in] LPNTMS_GUID lpObjectId, [in] LPNTMS_OBJECTINFORMATIONW lpInfo );
Opnum: 9 Disables an object. Opnum: 10 Enables an object. Opnum: 11 All methods MUST NOT throw exceptions. INtmsObjectManagement1::GetNtmsObjectSecurity (Opnum 3) The GetNtmsObjectSecurity method retrieves the security descriptor of an object. HRESULT GetNtmsObjectSecurity( [in] LPNTMS_GUID lpObjectId, [in] DWORD dwType, [in] DWORD SecurityInformation, [out, size_is(nLength)] PSECURITY_DESCRIPTOR_NTMS lpSecurityDescriptor, [in] DWORD nLength, [out] DWORD* lpnLengthNeeded ); lpObjectId: A pointer to the identifier of the object for which to retrieve information. dwType: A value from the enumeration specifying the type of the object. SecurityInformation: A SECURITY_INFORMATION structure specifying the security data to retrieve. lpSecurityDescriptor: A pointer to a SECURITY_DESCRIPTOR structure that describes the security of the object. nLength: The size, in bytes, of the client buffer for lpSecurityDescriptor. lpnLengthNeeded: A pointer to the required size of lpSecurityDescriptor if the specified client buffer was not large enough. Return value/code Description 0x00000000 S_OK The call was successful. 0x80070005 ERROR_ACCESS_DENIED Access to an object was denied. 0x80070057 ERROR_INVALID_PARAMETER A parameter is not valid. 0x8007007A ERROR_INSUFFICIENT_BUFFER The specified buffer size is not large enough. 0x80070546 ERROR_NO_SECURITY_ON_OBJECT The object has no security information. 0x800710D8 ERROR_OBJECT_NOT_FOUND The object was not found.
NTMS_OPREQ_MESSAGE 0x00000005 MUST be set to NULL. lpArg2Id: This parameter MUST be set according to the value of dwRequest. Value 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 found. 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 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 requests are used to request media, to request that the specified medium be moved from one library to another, or to request the server device service. Upon receiving this message, the server MUST verify that lpRequestId and lpMessage are not NULL. If parameter validation fails, the server MUST immediately fail the operation and return ERROR_INVALID_PARAMETER (0x80070057).
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
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
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 64 70 Server 67