estructura NTMS_LIBREQUESTINFORMATIONA (ntmsapi.h)

  • Artículo

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La estructura NTMS_LIBREQUESTINFORMATION define las propiedades específicas de una solicitud de trabajo, que se ponen en cola en RSM.

Sintaxis

typedef struct _NTMS_LIBREQUESTINFORMATIONA {
  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;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONA;

Miembros

OperationCode

Operación de elemento. Puede ser uno de los siguientes valores.

Valor Significado
NTMS_LM_CLASSIFY
 Clasifique el medio.
NTMS_LM_CLEANDRIVE
 Limpie una unidad.
NTMS_LM_DISABLELIBRARY
 Deshabilite el modificador.
NTMS_LM_DISABLEDRIVE
 Deshabilite una unidad.
NTMS_LM_DISABLEMEDIA
 Deshabilite el medio.
NTMS_LM_DISMOUNT
 Desmontar el medio de una unidad.
NTMS_LM_DOORACCESS
 Permitir el acceso a medios a través de una puerta de unidad de biblioteca.
NTMS_LM_EJECT
 Expulse el medio de la biblioteca.
NTMS_LM_EJECTCLEANER
 Expulse un limpiador.
NTMS_LM_ENABLELIBRARY
 Habilite el modificador.
NTMS_LM_ENABLEDRIVE
 Habilite una unidad.
NTMS_LM_ENABLEMEDIA
 Habilite el medio.
NTMS_LM_INJECT
 Inserte el medio en la biblioteca.
NTMS_LM_INJECTCLEANER
 Inserte un limpiador.
NTMS_LM_INVENTORY
 Realice un inventario de la biblioteca.
NTMS_LM_MOUNT
 Monte un lado en una unidad.
NTMS_LM_PROCESSOMID
 Procese el OMID.
NTMS_LM_RELEASECLEANER
 Suelte una ranura más limpia.
NTMS_LM_REMOVE
 Quite un elemento de trabajo de la cola.
NTMS_LM_RESERVECLEANER
 Reserve una ranura más limpia.
NTMS_LM_UPDATEOMID
 Actualice el OMID.
NTMS_LM_WRITESCRATCH
 Escriba una etiqueta gratuita.

OperationOption

Opciones de elemento de trabajo (específica del comando).

State

Estado actual de este elemento de trabajo. Puede ser uno de los siguientes valores.

Valor Significado
NTMS_LM_QUEUED
 La operación se pone en cola.
NTMS_LM_INPROCESS
 La operación se está procesando.
NTMS_LM_PASSED
 Operación completada correctamente.
NTMS_LM_FAILED
 La operación se ha completado con un error.
NTMS_LM_WAITING
 La operación está bloqueada.
NTMS_LM_CANCELLED
 Se ha cancelado la operación.
NTMS_LM_INVALID
 La operación no es válida.

PartitionId

Identificador único de un lado al que se va a atender.

DriveId

Identificador único de una unidad que se va a atender.

PhysMediaId

Identificador único de un elemento de medios físicos que se está realizando el servicio.

Library

Biblioteca para esta solicitud.

SlotId

Identificador único de una ranura del elemento de medios físicos que se va a atender.

TimeQueued

Hora del sistema en la que esta solicitud se puso en cola en RSM.

TimeCompleted

Hora del sistema en la que RSM completó esta solicitud.

szApplication[NTMS_APPLICATIONNAME_LENGTH]

Aplicación que envió la solicitud del operador.

szUser[NTMS_USERNAME_LENGTH]

El usuario interactivo inició sesión en el equipo que envió la solicitud del operador.

szComputer[NTMS_COMPUTERNAME_LENGTH]

Equipo que envió la solicitud del operador.

dwErrorCode

Se devuelve un error para las solicitudes que devuelven con el estado NTMS_LM_FAILED. Se trata de un código de error del sistema.

WorkItemId

Id. de elemento de trabajo asociado para esta solicitud. Actualmente se usa para contener el identificador de elemento de trabajo que se va a cancelar en una solicitud de NTMS_LM_REMOVE.

dwPriority

Prioridad del elemento de trabajo.

Comentarios

La estructura NTMS_LIBREQUESTINFORMATION se incluye en la estructura NTMS_OBJECTINFORMATION .

Es posible que el GUID de los tiempos de trabajo no sea válido a lo largo del tiempo. Por ejemplo, una expulsión de un medio libre elimina el PMID después de que se expulse el medio. Sin embargo, el elemento de trabajo no se actualiza al finalizar la expulsión.

Nota

El encabezado ntmsapi.h define NTMS_LIBREQUESTINFORMATION como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado ntmsapi.h

Consulte también

NTMS_OBJECTINFORMATION