通过

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
Library Ntmsapi.lib
DLL Ntmsapi.dll

另请参阅

GetNtmsRequestOrder

库控件函数