NTMS_OPREQUESTINFORMATIONA結構 (ntmsapi.h)

  • 發行項

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

NTMS_OPREQUESTINFORMATION結構會定義 RSM 操作員要求系統控制件特有的屬性。

語法

typedef struct _NTMS_OPREQUESTINFORMATIONA {
  DWORD      Request;
  SYSTEMTIME Submitted;
  DWORD      State;
  CHAR       szMessage[NTMS_MESSAGE_LENGTH];
  DWORD      Arg1Type;
  NTMS_GUID  Arg1;
  DWORD      Arg2Type;
  NTMS_GUID  Arg2;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
} NTMS_OPREQUESTINFORMATIONA;

成員

Request

運算元要求的類型。 這可以是下列其中一個值。

值 意義
NTMS_OPREQ_NEWMEDIA
 當沒有媒體可用時，嘗試配置媒體的應用程式會傳送新媒體的操作員要求。 設定此旗標時， Arg1 成員應該設定為需要新媒體之媒體集區的 GUID。 您可以選擇性地將 Arg2 成員設定為應該放置新媒體的特定連結庫。
NTMS_OPREQ_CLEANER
 RSM 會在清除作業排入佇列時傳送操作員要求，且磁碟驅動器上沒有清除器可供使用。 設定此旗標時， Arg1 成員應該設定為需要清除針筒的連結庫 GUID。
NTMS_OPREQ_DEVICESERVICE
 當變更器裝置或磁碟驅動器發生問題時，應用程式或 RSM 會傳送磁碟驅動器服務的操作員要求。 設定此旗標時， Arg1 成員應該設定為需要服務的裝置 GUID。
NTMS_OPREQ_MOVEMEDIA
 應用程式或 RSM 會傳送操作員要求，將指定的媒體移至服務離線媒體的掛接，或退出媒體至離線媒體庫。 設定此旗標時， Arg1 成員應該設定為要移動的實體媒體 GUID， 而 Arg2 成員應該設定為媒體庫的 GUID。此媒體應移至此媒體庫的 GUID。
NTMS_OPREQ_MESSAGE
 應用程式特定的操作員要求。 僅限文字。

Submitted

提交操作員要求的系統時間。

State

操作員服務要求的目前狀態。 這可以是下列其中一個值。

值 意義
NTMS_OPSTATE_SUBMITTED
 操作員要求已提交，但未由操作員控制台讀取。
NTMS_OPSTATE_ACTIVE
 操作員要求已由一或多個操作員控制台讀取，而且可能正在處理中。
NTMS_OPSTATE_INPROGRESS
 用戶已認可此操作員要求，且正在執行服務。
NTMS_OPSTATE_REFUSED
 用戶已拒絕操作員服務要求。
NTMS_OPSTATE_COMPLETE
 使用者已完成操作員服務要求。

szMessage[NTMS_MESSAGE_LENGTH]

運算子訊息文字。

Arg1Type

Arg1 對象的類型。 這可以是下列其中一個值。

值 意義
NTMS_UNKNOWN
 Arg1Type 中未提供任何物件。
NTMS_CHANGER
 中型變更器物件。
NTMS_DRIVE
 Drive 物件。
NTMS_IEDOOR
 Library door 物件。
NTMS_IEPORT。
 連結庫插入/退出埠物件
NTMS_LIBRARY
 Library 物件。
NTMS_PARTITION
 Side 物件。
NTMS_PHYSICAL_MEDIA
 實體媒體物件。
NTMS_STORAGESLOT
 連結庫位置物件。

Arg1

Arg1 對象識別碼，用於移動要求或其他需要參考對象的運算符要求。 此物件的用途會根據運算元要求的類型而有所不同。 如需 Arg1 的適當用法，請參閱 要求 描述。

Arg2Type

Arg2 物件的類型。 這可以是下列其中一個值。

值 意義
NTMS_UNKNOWN
 Arg2Type 中未提供任何物件。
NTMS_LIBRARY
 Library 物件。

Arg2

Arg2 對象識別碼，用於需要第二個參考對象的運算符要求。 此物件的用途會根據運算元要求的類型而有所不同。 如需 Arg2 的適當用法，請參閱 要求 描述。

szApplication[NTMS_APPLICATIONNAME_LENGTH]

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

szUser[NTMS_USERNAME_LENGTH]

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

szComputer[NTMS_COMPUTERNAME_LENGTH]

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

備註

NTMS_OPREQUESTINFORMATION 結構包含在 NTMS_OBJECTINFORMATION 結構中。

注意

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

規格需求

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

另請參閱

NTMS_OBJECTINFORMATION