estructura NTMS_DRIVEINFORMATIONW (ntmsapi.h)

[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_DRIVEINFORMATIONW {
  DWORD      Number;
  DWORD      State;
  NTMS_GUID  DriveType;
  WCHAR      szDeviceName[NTMS_DEVICENAME_LENGTH];
  WCHAR      szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
  WCHAR      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_DRIVEINFORMATIONW;

Miembros

Number

Número de la unidad de la biblioteca. Se establece en cero o en uno relativo el valor en función del sistema de numeración de unidades del dispositivo. Algunas unidades de número de modificadores a partir de cero y algunos modificadores comienzan con 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 se monta 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 del husillo o la carga de medios de cinta en el mecanismo principal.
NTMS_DRIVESTATE_UNLOADED	El medio se ha desmontado por la unidad y está listo para abrirse. Este estado indica que el husillo se ha detenido o que 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 (sin procesar, 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 realizar un desmontaje diferido. El valor predeterminado es de 5 minutos. Este miembro no se aplica a las bibliotecas independientes. Este miembro es grabable.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	ntmsapi.h

Consulte también

NTMS_OBJECTINFORMATION