GetNtmsRequestOrder function (ntmsapi.h)

Article
10/13/2021

[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]

The GetNtmsRequestOrder function gets the order that the specified request will be processed in the library queue.

Syntax

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

Parameters

[in] hSession

Handle to the session returned by the OpenNtmsSession function.

[in] lpRequestId

Unique identifier of a library request.

[out] lpdwOrderNumber

Order in which this request will be processed in the queue.

Return value

This function returns one of the following values.

Value	Meaning
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS to the computer is denied. Other security errors are also possible, but they would indicate a security subsystem error. Windows XP: No access rights are required.
ERROR_DATABASE_FAILURE	The database is inaccessible or damaged.
ERROR_INVALID_HANDLE	The session handle is missing or is not valid.
ERROR_INVALID_PARAMETER	The library request identifier is missing.
ERROR_OBJECT_NOT_FOUND	A request object with the specified identifier cannot be found.
ERROR_SUCCESS	The function was successful.

Remarks

If the GetNtmsRequestOrder function returns zero in lpdwOrderNumber, ordering is not available for this request. The order number is specific to the type of request because the types are processed in a predetermined order.

For example, the NTMS_LM_DISMOUNT request is processed prior to an NTMS_LM_MOUNT request. Within a specific class of requests the queue can be ordered, however. The lower-ordered requests are processed first, for example, 1 is the first request processed, 2 is the next request processed, and so forth.

You can use this order number, the request type, the submission time, and the submission date to help view the queue in sorted order. Request type, order number, and submission time should perform sorting.

Currently on NTMS_LM_MOUNT, requests are sorted using the order number.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	ntmsapi.h
Library	Ntmsapi.lib
DLL	Ntmsapi.dll