SubmitNtmsOperatorRequestW 函式 (ntmsapi.h)

發行項
03/05/2024

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

SubmitNtmsOperatorRequest 函式會提交 RSM 運算元要求。

語法

DWORD SubmitNtmsOperatorRequestW(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCWSTR     lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

參數

[in] hSession

OpenNtmsSession 函式所傳回之會話的句柄。

[in] dwRequest

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

值	意義
NTMS_OPREQ_CLEANER	RSM 會傳送操作員要求，以在清除作業排入佇列且磁碟驅動器沒有清除程式可用時插入清除器。 lpArg1Id 參數可以是連結庫或位置標識碼。需要連結庫NTMS_CONTROL_ACCESS。 Windowsxp：不需要任何訪問許可權。
NTMS_OPREQ_DEVICESERVICE	當變更器裝置或磁碟驅動器發生問題時，應用程式或 RSM 會傳送磁碟驅動器服務的操作員要求。 lpArg1Id 參數會指定需要服務的裝置。此參數可以是 iedoor、連結庫、實體媒體或磁碟驅動器識別碼。需要連結庫NTMS_CONTROL_ACCESS。 Windowsxp：不需要任何訪問許可權。
NTMS_OPREQ_MESSAGE	僅限應用程式訊息。需要NTMS_USE_ACCESS計算機。 Windowsxp：不需要任何訪問許可權。
NTMS_OPREQ_MOVEMEDIA	應用程式或 RSM 會傳送操作員要求，以將媒體從一個媒體庫移至另一個媒體庫，以便掛接離機媒體，或退出現有的媒體至離線媒體庫。 lpArg1Id 參數會指定必須移動的實體媒體片段，而 lpArg2Id 參數會指定目標連結庫。需要NTMS_CONTROL_ACCESS媒體集區。 Windowsxp：不需要任何訪問許可權。
NTMS_OPREQ_NEWMEDIA	當沒有媒體可用時，應用程式或 RSM 會傳送新媒體的操作員要求。 lpArg1Id 參數會指定媒體集區物件，而 lpArg2Id 參數是要新增新媒體的選擇性連結庫標識碼。需要NTMS_CONTROL_ACCESS媒體集區。 Windowsxp：不需要任何訪問許可權。

[in] lpMessage

要傳送給用戶的選擇性訊息字串。

[in] lpArg1Id

運算元要求的物件標識碼。如需此參數必須傳遞的物件類型描述，請參閱 dwRequest 參數中值的描述。

[in] lpArg2Id

運算元要求的物件標識碼。如需此參數必須傳遞的物件類型詳細數據，請參閱 dwRequest 參數中值的描述。

[out] lpRequestId

緩衝區的指標，接收已建立之運算符要求的標識碼。

傳回值

此函式會傳回下列其中一個值。

值	意義
ERROR_ACCESS_DENIED	拒絕存取一或多個 RSM 物件。
ERROR_DATABASE_FAILURE	資料庫查詢或更新失敗。
ERROR_INVALID_HANDLE	hSession 參數中指定的值為 NULL 或無效。
ERROR_INVALID_PARAMETER	其中一個參數值無效。
ERROR_NOT_CONNECTED	無法連線到 RSM 服務。
ERROR_OBJECT_NOT_FOUND	找不到來源或目的地物件。
ERROR_SUCCESS	函式成功。

備註

SubmitNtmsOperatorRequest 函式會提交運算符要求，並傳回要求的狀態 (滿足或取消) ，如果運算符未處理要求) ，則傳回 (。操作員要求是用來要求媒體、要求指定的媒體從某個連結庫移到另一個媒體櫃，或要求 RSM 裝置服務。

dwRequest 參數) 中的NTMS_OPEREQ_MESSAGE值 (是應用程式最常使用的要求類型。 RSM 無法使用NTMS_OPEREQ_MESSAGE。 RSM 會視需要使用其他要求類型。

注意

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

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	ntmsapi.h
程式庫	Ntmsapi.lib
Dll	Ntmsapi.dll