SubmitNtmsOperatorRequestA 函式（ntmsapi.h）

發行項
11/20/2024

[ 從 Windows 7 和 Windows Server 2008 R2 起，卸除式存儲設備管理員已無法使用。]

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

語法

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      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。 Windows XP：不需要訪問許可權。
NTMS_OPREQ_DEVICESERVICE	當變更器裝置或磁碟驅動器發生問題時，應用程式或 RSM 會傳送磁碟驅動器服務的操作員要求。 lpArg1Id 參數會指定需要服務的裝置。此參數可以是 iedoor、連結庫、實體媒體或磁碟驅動器識別碼。需要連結庫NTMS_CONTROL_ACCESS。 Windows XP：不需要訪問許可權。
NTMS_OPREQ_MESSAGE	僅限應用程式訊息。需要NTMS_USE_ACCESS計算機。 Windows XP：不需要訪問許可權。
NTMS_OPREQ_MOVEMEDIA	應用程式或 RSM 會傳送操作員要求，將媒體從某個媒體櫃移至另一個媒體櫃，以便掛接離線媒體，或將現有的媒體退出至離線媒體庫。 lpArg1Id 參數會指定必須移動的實體媒體片段，而 lpArg2Id 參數會指定目標連結庫。需要媒體集區NTMS_CONTROL_ACCESS。 Windows XP：不需要訪問許可權。
NTMS_OPREQ_NEWMEDIA	當沒有媒體可用時，應用程式或 RSM 會傳送新媒體的操作員要求。 lpArg1Id 參數會指定媒體集區物件，而 lpArg2Id 參數是新增新媒體的選擇性連結庫標識符。需要媒體集區NTMS_CONTROL_ACCESS。 Windows XP：不需要訪問許可權。

[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 裝置服務。

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

注意

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

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	ntmsapi.h
連結庫	Ntmsapi.lib
DLL	Ntmsapi.dll