GetNtmsRequestOrder 函式 (ntmsapi.h)

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

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

語法

DWORD GetNtmsRequestOrder(
  [in]  HANDLE      hSession,
  [in]  LPNTMS_GUID lpRequestId,
  [out] LPDWORD     lpdwOrderNumber
);

[in] hSession

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

[in] lpRequestId

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

[out] lpdwOrderNumber

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

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

值	意義
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS電腦遭到拒絕。其他安全性錯誤也是可行的，但它們會指出安全性子系統錯誤。 Windowsxp：不需要任何訪問許可權。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_INVALID_PARAMETER	連結庫要求標識碼遺失。
ERROR_OBJECT_NOT_FOUND	找不到具有指定標識碼的要求物件。
ERROR_SUCCESS	函式成功。

如果 GetNtmsRequestOrder 函式在 lpdwOrderNumber 中傳回零，則此要求無法使用排序。訂單號碼是要求類型特有的，因為類型是以預先決定的順序處理。

例如，NTMS_LM_DISMOUNT要求是在NTMS_LM_MOUNT要求之前處理。不過，在佇列可以排序的特定要求類別內。先處理較低排序的要求，例如，1 是處理的第一個要求，2 是下一個已處理的要求，依此類推。

您可以使用此訂單號碼、要求類型、提交時間和提交日期，以排序順序協助檢視佇列。要求類型、訂單號碼和提交時間應該執行排序。

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