Share via

2.2.4.27 NTMS_OPREQUESTINFORMATIONA Structure

  • Article

The NTMS_OPREQUESTINFORMATIONA structure describes the properties of an operator request, in ASCII.

 typedef struct _NTMS_OPREQUESTINFORMATIONA {
   DWORD Request;
   SYSTEMTIME Submitted;
   DWORD State;
   char szMessage[256];
   DWORD Arg1Type;
   NTMS_GUID Arg1;
   DWORD Arg2Type;
   NTMS_GUID Arg2;
   char szApplication[64];
   char szUser[64];
   char szComputer[64];
 } NTMS_OPREQUESTINFORMATIONA;

Request: The value from the NtmsOpreqCommand enumeration that specifies the type of the operator request.

Submitted: A SYSTEMTIME structure that specifies the time at which the request was submitted.

State: A value from the NtmsOpreqState enumeration that specifies the state of the operator request.

szMessage: A null-terminated string that contains operator message text. For example, "The cleaner cartridge in %s (slot #%d) has reached its maximum usage and needs to be replaced."

Arg1Type: A value from the NtmsObjectsTypes enumeration that specifies the type of object in Arg1.

Arg1: This parameter MUST be set based on the value of Request.

If Request = NTMS_OPREQ_NEWMEDIA (0x00000001), Arg1 MUST be set to the identifier of the media pool requiring new media.

If Request = NTMS_OPREQ_CLEANER (0x00000002), Arg1 MUST be set to the identifier of the library requiring the cleaner cartridge.

If Request = NTMS_OPREQ_DEVICESERVICE (0x00000003), Arg1 MUST be set to the identifier of the device requiring service.

If Request = NTMS_OPREQ_MOVEMEDIA (0x00000004), Arg1 MUST be set to the identifier of the physical medium to move.

Arg2Type: A value from the NtmsObjectsTypes enumeration that specifies the type of object in Arg2.

Arg2: This parameter MUST be set based on the value of Request.

If Request = NTMS_OPREQ_NEWMEDIA (0x00000001), Arg2 MAY be set to the identifier of the library in which the new media MUST be placed.

If Request = NTMS_OPREQ_MOVEMEDIA (0x00000004), Arg2 MUST be set to the identifier of the library to which the physical medium MUST be moved.

szApplication: A null-terminated sequence of Unicode characters that specifies the name of the application that submitted the operator request.

szUser: A null-terminated sequence of Unicode characters that specifies the name of the interactive user who submitted the operator request.

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