2.2.4.17 NTMS_LIBREQUESTINFORMATIONW Structure

The NTMS_LIBREQUESTINFORMATIONW structure describes the properties of a work request, in Unicode.

 typedef struct _NTMS_LIBREQUESTINFORMATIONW {
   DWORD OperationCode;
   DWORD OperationOption;
   DWORD State;
   NTMS_GUID PartitionId;
   NTMS_GUID DriveId;
   NTMS_GUID PhysMediaId;
   NTMS_GUID Library;
   NTMS_GUID SlotId;
   SYSTEMTIME TimeQueued;
   SYSTEMTIME TimeCompleted;
   [string] wchar_t szApplication[64];
   [string] wchar_t szUser[64];
   [string] wchar_t szComputer[64];
   DWORD dwErrorCode;
   NTMS_GUID WorkItemId;
   DWORD dwPriority;
 } NTMS_LIBREQUESTINFORMATIONW;

OperationCode: A value from the NtmsLmOperation enumeration specifying the type of operation requested.

OperationOption: Options specific to a library request. The following table shows the meanings if OperationCode is set to LM_MOUNT, LM_DISMOUNT, or LM_EJECT.

Value	Meaning
IMMEDIATE 0x00000000	The operation MUST be completed immediately.
DEFERRED 0x00000001	The operation MUST be completed only when the slot is later required for an operation.
FORCEIMMEDIATE 0x00000002	The operation MUST be completed immediately. The operation will complete even if there are open handles to the medium.
FORCEDEFERRED 0x00000003	The operation MUST be completed only when the slot is later required for an operation. The operation MUST complete even if there are open handles to the medium.
INJECTMANY 0x00000004	The operation applies to multiple slots.

The following table shows the meanings if OperationCode is set to LM_INVENTORY.

Value	Meaning
FULL_INVENTORY 0x00000000	A complete inventory of media MUST be done.
SLOTS_ONLY 0x00000001	Only the media loaded into slots MUST be inventoried.

State: A value from the NtmsLmState (section 2.2.1.10) enumeration specifying the state of the work request.

PartitionId: The identifier of a side for which the request is submitted to the server.

DriveId: The identifier of a drive that is being serviced.

PhysMediaId: The identifier of a piece of physical media that is being serviced.

Library: The identifier of the library for the request.

SlotId: The identifier of the slot of the piece of physical media that is being serviced.

TimeQueued: A SYSTEMTIME structure specifying the time at which the request was queued.

TimeCompleted: A SYSTEMTIME structure specifying the time at which the request was completed.

szApplication: A null-terminated sequence of Unicode UTF-16 characters specifying the name of the application that submitted the operator request.<11>

szUser: A null-terminated sequence of Unicode UTF-16 characters specifying the name of the interactive user who submitted the operator request.

szComputer: A null-terminated sequence of Unicode UTF-16 characters specifying the name of the computer that submitted the operator request.

dwErrorCode: An implementation-specific nonzero error code for requests that return with State set to the NTMS_LM_FAILED value.<12>

WorkItemId: The associated identifier for the request, which is assigned by a server when it receives a request from a client to perform an operation on a library.

dwPriority: The priority of the request.