3.2.5.2.1.9 INtmsLibraryControl1::ReleaseNtmsCleanerSlot (Opnum 12)

  • Article

The ReleaseNtmsCleanerSlot method removes an existing slot reservation for a cleaning cartridge.

 HRESULT ReleaseNtmsCleanerSlot(
   [in] LPNTMS_GUID lpLibrary
 );

lpLibrary: A pointer to the identifier of the media library from which to remove the slot reservation.

Upon receiving this message, the server MUST validate that lpLibrary is not NULL. If it is NULL, 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 processing further. If the client does not have the required access rights, the server MUST return ERROR_ACCESS_DENIED (0x80070005). 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 ReleaseNtmsCleanerSlot method removes an existing slot reservation for a cleaning cartridge. The slot can then be used for data cartridges. For the ReleaseNtmsCleanerSlot method to succeed, the slot MUST be present and empty. The library MUST also have a slot reserved for cleaning.

On completion of an asynchronous operation, notification will be sent with the identifier lpLibrary.