共用方式為

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