estructura NTMS_DRIVEINFORMATIONA (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_DRIVEINFORMATION define las propiedades específicas de un objeto de unidad.

Sintaxis

typedef struct _NTMS_DRIVEINFORMATIONA {
  DWORD      Number;
  DWORD      State;
  NTMS_GUID  DriveType;
  CHAR       szDeviceName[NTMS_DEVICENAME_LENGTH];
  CHAR       szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
  CHAR       szRevision[NTMS_REVISION_LENGTH];
  WORD       ScsiPort;
  WORD       ScsiBus;
  WORD       ScsiTarget;
  WORD       ScsiLun;
  DWORD      dwMountCount;
  SYSTEMTIME LastCleanedTs;
  NTMS_GUID  SavedPartitionId;
  NTMS_GUID  Library;
  GUID       Reserved;
  DWORD      dwDeferDismountDelay;
} NTMS_DRIVEINFORMATIONA;

Miembros

Number

Número de la unidad de la biblioteca. Se establece cero o uno relativo en función del sistema de numeración de unidades del dispositivo. Algunos modificadores numeran unidades que comienzan por cero y algunos modificadores comienzan por uno.

State

Estado de la unidad. Puede ser uno de los siguientes valores.

Valor Significado
NTMS_DRIVESTATE_BEING_CLEANED
 La unidad se está limpiando y no está disponible.
NTMS_DRIVESTATE_DISMOUNTABLE
 Si se establece una biblioteca para desmontaje diferido, el medio podría dejarse en la unidad de la biblioteca en un desmontaje. RSM puede satisfacer las solicitudes de montaje de unidades cargadas y desmontadas.
NTMS_DRIVESTATE_DISMOUNTED
 No hay medio en la unidad.
NTMS_DRIVESTATE_LOADED
 El medio se monta en la unidad y se carga para el acceso de lectura y escritura.
NTMS_DRIVESTATE_MOUNTED
 El medio está montado en la unidad, pero no está listo para el acceso de lectura y escritura. Se trata de un estado temporal que se usa mientras una unidad está esperando la sincronización de ejes o cargando medios de cinta en el mecanismo principal.
NTMS_DRIVESTATE_UNLOADED
 El medio ha sido desmontado por la unidad y está listo para abrirse. Este estado indica que el husillo se ha detenido o se ha devuelto un soporte de cinta al cartucho de cinta.

DriveType

Identificador único del objeto de tipo de unidad que contiene los atributos de la unidad.

szDeviceName[NTMS_DEVICENAME_LENGTH]

Nombre del dispositivo usado para acceder a la unidad. Para una unidad de cinta, contiene el nombre del dispositivo \.\tape0 o \.\tape1. Otros dispositivos proporcionan el nombre de una unidad de disco SCSI o la raíz de un sistema de archivos que actualmente tiene el dispositivo montado (raw, NTFS, FAT, etc.).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

Número de serie de la unidad representada como una cadena. Los dispositivos que no admiten números de serie notifican NULL para este miembro.

szRevision[NTMS_REVISION_LENGTH]

Revisión de la unidad representada como una cadena.

ScsiPort

Adaptador de host SCSI al que está conectada la unidad.

ScsiBus

Bus SCSI al que está conectada la unidad.

ScsiTarget

Identificador de destino SCSI para la unidad.

ScsiLun

Identificador de unidad lógica SCSI para la unidad.

dwMountCount

Número de veces que la unidad ha tenido un medio montado en él. Si la unidad admite la generación de informes de un número de serie único, este valor es el número de veces que se ha montado la unidad desde que se instaló. Si la unidad no admite la generación de informes de números de serie, este miembro refleja el número de montajes en todas las unidades de esa ubicación.

LastCleanedTs

Última vez que se limpió la unidad.

SavedPartitionId

Identificador de partición del medio que está en la unidad. Si este valor es NULL y se encuentra que la unidad está llena, un usuario cargó el medio y debe clasificarse.

Library

Identificador único de la biblioteca que contiene la unidad.

Reserved

Reservado.

dwDeferDismountDelay

Número mínimo de segundos que un medio permanecerá en una unidad de una biblioteca después de que se haya realizado un desmontaje diferido. El valor predeterminado es 5 minutos. Este miembro no se aplica a las bibliotecas independientes. Este miembro es grabable.

Comentarios

La estructura NTMS_DRIVEINFORMATION se incluye en la estructura NTMS_OBJECTINFORMATION .

Nota

El encabezado ntmsapi.h define NTMS_DRIVEINFORMATION 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