estructura NTMS_LIBREQUESTINFORMATIONA (ntmsapi.h)

[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