struttura NTMS_OBJECTINFORMATIONA (ntmsapi.h)
[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]
La struttura NTMS_OBJECTINFORMATION definisce le proprietà che un'applicazione può ottenere e impostare per dispositivi RSM, supporti e controlli di sistema, ad esempio librerie, unità, supporti, richieste di operatore. Si tratta della struttura comune degli oggetti nel database RSM.
Sintassi
typedef struct _NTMS_OBJECTINFORMATIONA {
DWORD dwSize;
DWORD dwType;
SYSTEMTIME Created;
SYSTEMTIME Modified;
NTMS_GUID ObjectGuid;
BOOL Enabled;
DWORD dwOperationalState;
CHAR szName[NTMS_OBJECTNAME_LENGTH];
CHAR szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
union {
NTMS_DRIVEINFORMATIONA Drive;
NTMS_DRIVETYPEINFORMATIONA DriveType;
NTMS_LIBRARYINFORMATION Library;
NTMS_CHANGERINFORMATIONA Changer;
NTMS_CHANGERTYPEINFORMATIONA ChangerType;
NTMS_STORAGESLOTINFORMATION StorageSlot;
NTMS_IEDOORINFORMATION IEDoor;
NTMS_IEPORTINFORMATION IEPort;
NTMS_PMIDINFORMATIONA PhysicalMedia;
NTMS_LMIDINFORMATION LogicalMedia;
NTMS_PARTITIONINFORMATIONA Partition;
NTMS_MEDIAPOOLINFORMATION MediaPool;
NTMS_MEDIATYPEINFORMATION MediaType;
NTMS_LIBREQUESTINFORMATIONA LibRequest;
NTMS_OPREQUESTINFORMATIONA OpRequest;
NTMS_COMPUTERINFORMATION Computer;
} Info;
#else
union {
NTMS_DRIVEINFORMATIONA Drive;
NTMS_DRIVETYPEINFORMATIONA DriveType;
NTMS_LIBRARYINFORMATION Library;
NTMS_CHANGERINFORMATIONA Changer;
NTMS_CHANGERTYPEINFORMATIONA ChangerType;
NTMS_STORAGESLOTINFORMATION StorageSlot;
NTMS_IEDOORINFORMATION IEDoor;
NTMS_IEPORTINFORMATION IEPort;
NTMS_PMIDINFORMATIONA PhysicalMedia;
NTMS_LMIDINFORMATION LogicalMedia;
NTMS_PARTITIONINFORMATIONA Partition;
NTMS_MEDIAPOOLINFORMATION MediaPool;
NTMS_MEDIATYPEINFORMATION MediaType;
NTMS_LIBREQUESTINFORMATIONA LibRequest;
NTMS_OPREQUESTINFORMATIONA OpRequest;
NTMS_COMPUTERINFORMATION Computer;
} Info;
#endif
} NTMS_OBJECTINFORMATIONA, *LPNTMS_OBJECTINFORMATIONA;
Members
dwSize
Tipo: DWORD
Dimensioni della struttura delle informazioni, in byte. Questo membro deve essere impostato sulla dimensione corretta della struttura prima di usare la funzione GetNtmsObjectInformation o la funzione SetNtmsObjectInformation .
dwType
Tipo: DWORD
Tipo di dispositivo o controllo di sistema per cui ottenere/impostare le informazioni. Questo membro deve essere impostato su uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Un oggetto changer rappresenta l'elemento robotico di un'unità di libreria. Il membro Info è un puntatore a una struttura NTMS_CHANGERINFORMATION . |
|
Viene creato un oggetto tipo di modifica per ogni tipo di dispositivo del modificatore univoco collegato a un sistema. Il membro Info è un puntatore a una struttura NTMS_CHANGERTYPEINFORMATION . |
|
Oggetto computer corrente. Non esiste alcuna struttura per l'oggetto computer. Il membro Info è un puntatore a una struttura NTMS_COMPUTERINFORMATION . |
|
Un oggetto unità rappresenta un'unità nastro o un'unità disco. Il membro Info è un puntatore a una struttura NTMS_DRIVEINFORMATION . |
|
Viene creato un oggetto tipo di unità per ogni tipo di dispositivo di unità univoco collegato a un sistema. Il membro Info è un puntatore a una struttura NTMS_DRIVETYPEINFORMATION . |
|
Un oggetto NTMS_IEDOOR rappresenta il meccanismo di accesso tramite porta di un'unità di libreria. Il membro Info è un puntatore a una struttura NTMS_IEDOORINFORMATION . |
|
Un oggetto NTMS_IEPORT rappresenta la porta di inserimento/espulsione di un'unità di libreria. Il membro Info è un puntatore a una struttura NTMS_IEPORTINFORMATION . |
|
Un oggetto libreria rappresenta una libreria online o offline. Il membro Info è un puntatore a una struttura NTMS_LIBRARYINFORMATION . |
|
Viene creato un oggetto richiesta di libreria per ogni richiesta di una libreria per eseguire un'azione. Un elenco di richieste di libreria viene gestito da RSM come coda di lavoro da eseguire. Il membro Info è un puntatore a una struttura NTMS_LIBREQUESTINFORMATION . |
|
Handle primario utilizzato dalle applicazioni per accedere al supporto specificato. Nel caso di supporti multi-side, ogni lato viene considerato come un singolo supporto fisico. Il membro Info è un puntatore a una struttura NTMS_LMIDINFORMATION . |
|
Un pool di supporti è un raggruppamento logico di supporti. Tutti i supporti in un pool di supporti devono essere dello stesso tipo di supporto. Il membro Info è un puntatore a una struttura NTMS_MEDIAPOOLINFORMATION . |
|
Viene creato un oggetto tipo di supporto per ogni tipo di supporto univoco in un sistema. Il membro Info è un puntatore a una struttura NTMS_MEDIATYPEINFORMATION . |
|
Un oggetto richiesta dell'operatore rappresenta una richiesta RSM per ottenere le informazioni da un utente. Il membro Info è un puntatore a una struttura NTMS_OPREQUESTINFORMATION . |
|
Un oggetto side rappresenta un lato di un supporto fisico. Il membro Info è un puntatore a una struttura NTMS_PARTITIONINFORMATION . |
|
Un oggetto multimediale fisico rappresenta un nastro magnetico o un disco rimovibile. Un elemento multimediale fisico può contenere uno o più lati. Il membro Info è un puntatore a una struttura NTMS_PMIDINFORMATION . |
|
Un oggetto slot di archiviazione rappresenta uno degli slot che possono contenere il supporto specificato in una libreria. Il membro Info è un puntatore a una struttura NTMS_STORAGESLOTINFORMATION . |
Created
Tipo: SYSTEMTIME
Data/ora di creazione dell'oggetto.
Modified
Tipo: SYSTEMTIME
Indicatore di data/ora in cui l'oggetto è stato modificato.
ObjectGuid
Tipo: NTMS_GUID
GUID dell'oggetto .
Enabled
Tipo: BOOL
Indica se l'oggetto di controllo del dispositivo o del sistema è abilitato.
dwOperationalState
Tipo: DWORD
Definisce lo stato operativo corrente dell'oggetto. Può trattarsi di uno dei valori seguenti.
szName[NTMS_OBJECTNAME_LENGTH]
Tipo: TCHAR[NTMS_OBJECTNAME_LENGTH]
Nome dell'oggetto supporto, dispositivo o controllo di sistema. I nomi dei media e dei supporti logici possono essere modificati usando la funzione SetNtmsObjectInformation . Tutti gli altri nomi di oggetti sono di sola lettura.
szDescription[NTMS_DESCRIPTION_LENGTH]
Tipo: TCHAR[NTMS_DESCRIPTION_LENGTH]
Descrizione dell'oggetto di controllo del dispositivo o del sistema. La descrizione degli oggetti di controllo del dispositivo e del sistema può essere modificata usando la funzione SetNtmsObjectInformation . (scrivibile per tutti gli oggetti)
Info
Informazioni specifiche dell'oggetto di controllo del dispositivo o del sistema. Il formato di queste informazioni dipende dal membro dwType .
Info.Drive
Tipo: NTMS_DRIVEINFORMATION Questo formato viene usato se il valore dwType è NTMS_DRIVE.
Info.DriveType
Tipo: NTMS_DRIVETYPEINFORMATION Questo formato viene usato se il valore dwType è NTMS_DRIVE_TYPE.
Info.Library
Tipo: NTMS_LIBRARYINFORMATION Questo formato viene usato se il valore dwType è NTMS_LIBRARY.
Info.Changer
Tipo: NTMS_CHANGERINFORMATION Questo formato viene usato se il valore dwType è NTMS_CHANGER.
Info.ChangerType
Tipo: NTMS_CHANGERTYPEINFORMATION Questo formato viene usato se il valore dwType è NTMS_CHANGER_TYPE.
Info.StorageSlot
Tipo: NTMS_STORAGESLOTINFORMATION Questo formato viene usato se il valore dwType è NTMS_STORAGESLOT.
Info.IEDoor
Tipo: NTMS_IEDOORINFORMATION Questo formato viene usato se il valore dwType è NTMS_IEDOOR.
Info.IEPort
Tipo: NTMS_IEPORTINFORMATION Questo formato viene usato se il valore dwType è NTMS_IEPORT.
Info.PhysicalMedia
Tipo: NTMS_PMIDINFORMATION Questo formato viene usato se il valore dwType è NTMS_PHYSICAL_MEDIA.
Info.LogicalMedia
Tipo: NTMS_LMIDINFORMATION Questo formato viene usato se il valore dwType è NTMS_LOGICAL_MEDIA.
Info.Partition
Tipo: NTMS_PARTITIONINFORMATION Questo formato viene usato se il valore dwType è NTMS_PARTITION.
Info.MediaPool
Tipo: NTMS_MEDIAPOOLINFORMATION Questo formato viene usato se il valore dwType è NTMS_MEDIA_POOL.
Info.MediaType
Tipo: NTMS_MEDIATYPEINFORMATION Questo formato viene usato se il valore dwType è NTMS_MEDIA_TYPE.
Info.LibRequest
Tipo: NTMS_LIBREQUESTINFORMATION Questo formato viene usato se il valore dwType è NTMS_LIBREQUEST.
Info.OpRequest
Tipo: NTMS_OPREQUESTINFORMATION Questo formato viene usato se il valore dwType è NTMS_OPREQUEST.
Info.Computer
Commenti
Tutti i membri della struttura NTMS_OBJECTINFORMATION sono di sola lettura a livello di funzione RSM, a meno che non sia specificato come WRITABLE nella definizione del membro.
Nota
L'intestazione ntmsapi.h definisce NTMS_OBJECTINFORMATION come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | ntmsapi.h |