NTMS_LIBREQUESTINFORMATIONA 結構 (ntmsapi.h)

  • 發行項

[從 Windows 7 和 Windows Server 2008 R2 起，不再提供卸除式儲存管理員 。]

NTMS_LIBREQUESTINFORMATION 結構會定義工作要求的特定屬性，這些屬性會排入 RSM 佇列。

語法

typedef struct _NTMS_LIBREQUESTINFORMATIONA {
  DWORD      OperationCode;
  DWORD      OperationOption;
  DWORD      State;
  NTMS_GUID  PartitionId;
  NTMS_GUID  DriveId;
  NTMS_GUID  PhysMediaId;
  NTMS_GUID  Library;
  NTMS_GUID  SlotId;
  SYSTEMTIME TimeQueued;
  SYSTEMTIME TimeCompleted;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONA;

成員

OperationCode

項目作業。 這可以是下列其中一個值。

值 意義
NTMS_LM_CLASSIFY
 分類媒體。
NTMS_LM_CLEANDRIVE
 清除磁碟驅動器。
NTMS_LM_DISABLELIBRARY
 停用變更程式。
NTMS_LM_DISABLEDRIVE
 停用磁碟驅動器。
NTMS_LM_DISABLEMEDIA
 停用媒體。
NTMS_LM_DISMOUNT
 從磁碟驅動器卸除媒體。
NTMS_LM_DOORACCESS
 允許透過連結庫單位門存取媒體。
NTMS_LM_EJECT
 從連結庫退出媒體。
NTMS_LM_EJECTCLEANER
 退出清理器。
NTMS_LM_ENABLELIBRARY
 啟用變更程式。
NTMS_LM_ENABLEDRIVE
 啟用磁碟驅動器。
NTMS_LM_ENABLEMEDIA
 啟用媒體。
NTMS_LM_INJECT
 將媒體插入連結庫。
NTMS_LM_INJECTCLEANER
 插入更簡潔的 。
NTMS_LM_INVENTORY
 執行連結庫的清查。
NTMS_LM_MOUNT
 將側邊掛接至磁碟驅動器。
NTMS_LM_PROCESSOMID
 處理 OMID。
NTMS_LM_RELEASECLEANER
 釋放更簡潔的位置。
NTMS_LM_REMOVE
 從佇列中移除工作專案。
NTMS_LM_RESERVECLEANER
 保留更簡潔的位置。
NTMS_LM_UPDATEOMID
 更新 OMID。
NTMS_LM_WRITESCRATCH
 撰寫免費標籤。

OperationOption

工作項目選項 (特定命令) 。

State

此工作專案的目前狀態。 這可以是下列其中一個值。

值 意義
NTMS_LM_QUEUED
 作業已排入佇列。
NTMS_LM_INPROCESS
 正在處理作業。
NTMS_LM_PASSED
 作業順利完成。
NTMS_LM_FAILED
 作業已完成，併發生錯誤。
NTMS_LM_WAITING
 作業已遭到封鎖。
NTMS_LM_CANCELLED
 作業已取消。
NTMS_LM_INVALID
 作業無效。

PartitionId

服務端的唯一標識碼。

DriveId

正在服務之磁碟驅動器的唯一標識碼。

PhysMediaId

正在服務之實體媒體片段的唯一標識符。

Library

此要求的連結庫。

SlotId

所服務實體媒體之位置的唯一標識符。

TimeQueued

此要求已排入 RSM 佇列的系統時間。

TimeCompleted

RSM 完成此要求的系統時間。

szApplication[NTMS_APPLICATIONNAME_LENGTH]

提交操作員要求的應用程式。

szUser[NTMS_USERNAME_LENGTH]

互動式使用者登入提交操作員要求的計算機。

szComputer[NTMS_COMPUTERNAME_LENGTH]

提交操作員要求的計算機。

dwErrorCode

傳回狀態NTMS_LM_FAILED的要求發生錯誤傳回。 這是 系統錯誤碼。

WorkItemId

此要求的相關聯工作專案標識碼。 這目前用來包含NTMS_LM_REMOVE要求上要取消的工作專案標識碼。

dwPriority

工作專案的優先順序。

備註

NTMS_LIBREQUESTINFORMATION 結構包含在 NTMS_OBJECTINFORMATION 結構中。

工作時間中的 GUID 可能會隨著時間變得無效。 例如，退出免費媒體會在媒體退出之後刪除 PMID。 不過，完成退出時，工作專案不會更新。

注意

ntmsapi.h 標頭會將NTMS_LIBREQUESTINFORMATION定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 ntmsapi.h

另請參閱

NTMS_OBJECTINFORMATION