struttura NTMS_DRIVEINFORMATIONW (ntmsapi.h)

Articolo
11/20/2024

[ di Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La struttura NTMS_DRIVEINFORMATION definisce proprietà specifiche di un oggetto unità.

Sintassi

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;

Membri

Number

Numero dell'unità nella libreria. Viene impostato zero o un valore relativo in base al sistema di numerazione delle unità del dispositivo. Alcune unità numerino delle modifiche che iniziano con zero e alcune modifiche iniziano con una.

State

Stato dell'unità. Può trattarsi di uno dei valori seguenti.

Valore	Significato
NTMS_DRIVESTATE_BEING_CLEANED	L'unità viene pulita e non è disponibile.
NTMS_DRIVESTATE_DISMOUNTABLE	Se una libreria è impostata per smontaggio differita, il supporto potrebbe essere lasciato nell'unità della libreria su un smontaggio. RSM può soddisfare le richieste di montaggio per le unità caricate e smontate.
NTMS_DRIVESTATE_DISMOUNTED	Nessun supporto nell'unità.
NTMS_DRIVESTATE_LOADED	Il supporto è montato nell'unità e viene caricato per l'accesso in lettura e scrittura.
NTMS_DRIVESTATE_MOUNTED	Il supporto è montato nell'unità ma non è pronto per l'accesso in lettura e scrittura. Si tratta di uno stato temporaneo usato mentre un'unità è in attesa di sincronizzazione dello spindle o caricamento di supporti nastro nel meccanismo head.
NTMS_DRIVESTATE_UNLOADED	Il supporto è stato smontato dall'unità ed è pronto per essere aperto. Questo stato indica che lo spindle è stato arrestato o che un supporto nastro è stato restituito alla munizione nastro.

DriveType

Identificatore univoco dell'oggetto tipo di unità contenente gli attributi per l'unità.

szDeviceName[NTMS_DEVICENAME_LENGTH]

Nome del dispositivo usato per accedere all'unità. Per un'unità nastro che contiene il nome del dispositivo \.\tape0 o \.\tape1. Gli altri dispositivi forniscono il nome di un'unità disco SCSI o la radice di un file system in cui è attualmente montato il dispositivo (raw, NTFS, FAT e così via).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

Numero di serie per l'unità rappresentata come stringa. I dispositivi che non supportano i numeri di serie segnalano NULL per questo membro.

szRevision[NTMS_REVISION_LENGTH]

Revisione per l'unità rappresentata come stringa.

ScsiPort

Scheda host SCSI a cui è connessa l'unità.

ScsiBus

Bus SCSI a cui è connessa l'unità.

ScsiTarget

ID di destinazione SCSI per l'unità.

ScsiLun

ID unità logica SCSI per l'unità.

dwMountCount

Numero di volte in cui l'unità ha montato un supporto. Se l'unità supporta la segnalazione di un numero di serie univoco, questo valore corrisponde al numero di volte in cui l'unità è stata montata dopo l'installazione. Se l'unità non supporta la segnalazione dei numeri di serie, questo membro riflette il numero di montaggi in tutte le unità in tale posizione.

LastCleanedTs

Ultima volta che l'unità è stata pulita.

SavedPartitionId

Identificatore di partizione del supporto presente nell'unità. Se questo valore è NULL e l'unità viene trovata piena, il supporto è stato caricato da un utente e deve essere classificato.

Library

Identificatore univoco della libreria che contiene l'unità.

Reserved

Riservato.

dwDeferDismountDelay

Il numero minimo di secondi in cui un supporto rimarrà in un'unità di una libreria dopo l'esecuzione di un smontaggio posticipato. Il valore predefinito è 5 minuti. Questo membro non si applica alle librerie autonome. Questo membro è scrivibile.

Osservazioni

La struttura NTMS_DRIVEINFORMATION è inclusa nella struttura NTMS_OBJECTINFORMATION.

Nota

L'intestazione ntmsapi.h definisce NTMS_DRIVEINFORMATION come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	ntmsapi.h

Vedere anche

NTMS_OBJECTINFORMATION

Condividi tramite