共用方式為

SetNtmsRequestOrder 函式 (ntmsapi.h)

  • 發行項

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

SetNtmsRequestOrder 函式會設定指定的要求將在連結庫佇列中處理的順序。

語法

DWORD SetNtmsRequestOrder(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwOrderNumber
);

參數

[in] hSession

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

[in] lpRequestId

連結庫要求的唯一標識碼。

[in] dwOrderNumber

要求將在佇列中處理的順序。

傳回值

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

值 意義
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS電腦遭到拒絕。 也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。

Windowsxp： 不需要任何訪問許可權。
ERROR_DATABASE_FAILURE
 資料庫無法存取或損毀。
ERROR_INVALID_HANDLE
 會話句柄遺失或無效。
ERROR_INVALID_PARAMETER
 連結庫要求標識碼遺失。
ERROR_OBJECT_NOT_FOUND
 找不到具有指定標識碼的要求物件。
ERROR_SUCCESS
 函式成功。

備註

目前NTMS_LM_MOUNT要求會使用訂單號碼排序。

SetNtmsRequestOrder 函式所設定的順序號碼是要求類型特有的，因為類型是以預先決定的順序處理。 例如，在NTMS_LM_MOUNT要求之前，會先處理NTMS_LM_DISMOUNT要求。 不過，在佇列可排序的特定要求類別內。 系統會先處理較低的排序要求;例如，1 是處理的第一個要求，2 是下一個已處理的要求，依此類推。

若要立即處理要求，應用程式可以將訂單號碼設定為1。 若要延遲處理，應用程式應該將訂單編號設定為非常大或0xFFFFFFFF。 目前有零個訂單數目的要求順序編號無法變更。

規格需求

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

另請參閱

GetNtmsRequestOrder

連結庫控件函式