struttura NTMS_OBJECTINFORMATIONW (ntmsapi.h)
[ di 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_OBJECTINFORMATIONW {
DWORD dwSize;
DWORD dwType;
SYSTEMTIME Created;
SYSTEMTIME Modified;
NTMS_GUID ObjectGuid;
BOOL Enabled;
DWORD dwOperationalState;
WCHAR szName[NTMS_OBJECTNAME_LENGTH];
WCHAR szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
union {
NTMS_DRIVEINFORMATIONW Drive;
NTMS_DRIVETYPEINFORMATIONW DriveType;
NTMS_LIBRARYINFORMATION Library;
NTMS_CHANGERINFORMATIONW Changer;
NTMS_CHANGERTYPEINFORMATIONW ChangerType;
NTMS_STORAGESLOTINFORMATION StorageSlot;
NTMS_IEDOORINFORMATION IEDoor;
NTMS_IEPORTINFORMATION IEPort;
NTMS_PMIDINFORMATIONW PhysicalMedia;
NTMS_LMIDINFORMATION LogicalMedia;
NTMS_PARTITIONINFORMATIONW Partition;
NTMS_MEDIAPOOLINFORMATION MediaPool;
NTMS_MEDIATYPEINFORMATION MediaType;
NTMS_LIBREQUESTINFORMATIONW LibRequest;
NTMS_OPREQUESTINFORMATIONW OpRequest;
NTMS_COMPUTERINFORMATION Computer;
} Info;
#else
union {
NTMS_DRIVEINFORMATIONW Drive;
NTMS_DRIVETYPEINFORMATIONW DriveType;
NTMS_LIBRARYINFORMATION Library;
NTMS_CHANGERINFORMATIONW Changer;
NTMS_CHANGERTYPEINFORMATIONW ChangerType;
NTMS_STORAGESLOTINFORMATION StorageSlot;
NTMS_IEDOORINFORMATION IEDoor;
NTMS_IEPORTINFORMATION IEPort;
NTMS_PMIDINFORMATIONW PhysicalMedia;
NTMS_LMIDINFORMATION LogicalMedia;
NTMS_PARTITIONINFORMATIONW Partition;
NTMS_MEDIAPOOLINFORMATION MediaPool;
NTMS_MEDIATYPEINFORMATION MediaType;
NTMS_LIBREQUESTINFORMATIONW LibRequest;
NTMS_OPREQUESTINFORMATIONW OpRequest;
NTMS_COMPUTERINFORMATION Computer;
} Info;
#endif
} NTMS_OBJECTINFORMATIONW, *LPNTMS_OBJECTINFORMATIONW;
Membri
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
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 informazioni |
|
Viene creato un oggetto tipo di modificatore per ogni tipo di dispositivo changer univoco collegato a un sistema. Il membro |
|
Oggetto computer corrente. Non esiste alcuna struttura per l'oggetto computer. Il membro informazioni |
|
Un oggetto unità rappresenta un'unità nastro o un'unità disco. Il membro informazioni |
|
Viene creato un oggetto tipo di unità per ogni tipo di dispositivo di unità univoco collegato a un sistema. Il membro informazioni |
|
Un oggetto NTMS_IEDOOR rappresenta il meccanismo di accesso alla porta di un'unità di libreria. Il membro Info è un puntatore a una struttura di NTMS_IEDOORINFORMATION. |
|
Un oggetto NTMS_IEPORT rappresenta la porta di inserimento/inserimento di un'unità di libreria. Il membro informazioni |
|
Un oggetto libreria rappresenta una libreria online o offline. Il membro |
|
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 |
|
Handle primario utilizzato dalle applicazioni per accedere al supporto specificato. Nel caso di supporti multi-side, ogni lato viene considerato come un singolo elemento multimediale fisico. Il membro informazioni |
|
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 informazioni |
|
Viene creato un oggetto tipo di supporto per ogni tipo di supporto univoco in un sistema. Il membro informazioni |
|
Un oggetto richiesta operatore rappresenta una richiesta RSM per ottenere le informazioni da parte di un utente. Il membro informazioni |
|
Un oggetto laterale rappresenta un lato di un supporto fisico. Il membro info |
|
Un oggetto multimediale fisico rappresenta un nastro magnetico o un disco rimovibile. Una parte di supporti fisici 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 informazioni |
Created
Tipo: SYSTEMTIME
Data/ora di creazione dell'oggetto.
Modified
Tipo: SYSTEMTIME
Data/ora di modifica dell'oggetto.
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. È possibile modificare il pool di supporti e i nomi dei supporti logici usando la funzione setNtmsObjectInformation
szDescription[NTMS_DESCRIPTION_LENGTH]
Tipo: TCHAR[NTMS_DESCRIPTION_LENGTH]
Descrizione dell'oggetto di controllo del dispositivo o del sistema. La descrizione degli oggetti dispositivo e controllo di sistema può essere modificata usando la funzione SetNtmsObjectInformation. (scrivibile per tutti gli oggetti)
Info
Informazioni specifiche dell'oggetto del controllo del dispositivo o del sistema. Il formato di queste informazioni dipende dal membro dwType
Info.Drive
Info.DriveType
Info.Library
Info.Changer
Tipo: NTMS_CHANGERINFORMATION Questo formato viene utilizzato se il valore dwType è NTMS_CHANGER.
Info.ChangerType
Info.StorageSlot
Tipo: NTMS_STORAGESLOTINFORMATION Questo formato viene utilizzato se il valore dwType è NTMS_STORAGESLOT.
Info.IEDoor
Info.IEPort
Info.PhysicalMedia
Info.LogicalMedia
Tipo: NTMS_LMIDINFORMATION Questo formato viene utilizzato se il valore dwType è NTMS_LOGICAL_MEDIA.
Info.Partition
Info.MediaPool
Info.MediaType
Info.LibRequest
Info.OpRequest
Info.Computer
Osservazioni
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 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 |