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，请求使用订单号进行排序。