GetNtmsRequestOrder function (ntmsapi.h)

  • Article

[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

See also

Library Control Functions

SetNtmsRequestOrder