estructura NTMS_OBJECTINFORMATIONA (ntmsapi.h)
[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]
La estructura NTMS_OBJECTINFORMATION define las propiedades que una aplicación puede obtener y establecer para dispositivos RSM, medios y controles del sistema (como bibliotecas, unidades, medios, solicitudes de operador). Esta es la estructura común de objetos de la base de datos RSM.
Sintaxis
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;
Miembros
dwSize
Tipo: DWORD
Tamaño de la estructura de información, en bytes. Este miembro debe establecerse en el tamaño correcto de la estructura antes de usar la función GetNtmsObjectInformation o la función SetNtmsObjectInformation .
dwType
Tipo: DWORD
Tipo de dispositivo o control del sistema para el que se va a obtener o establecer información. Este miembro debe establecerse en uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
Un objeto changer representa el elemento robótico de una unidad de biblioteca. El miembro Info es un puntero a una estructura NTMS_CHANGERINFORMATION . |
|
Se crea un objeto de tipo de modificador para cada tipo de dispositivo de modificador único conectado a un sistema. El miembro Info es un puntero a una estructura de NTMS_CHANGERTYPEINFORMATION . |
|
Objeto de equipo actual. No hay ninguna estructura para el objeto de equipo. El miembro Info es un puntero a una estructura de NTMS_COMPUTERINFORMATION . |
|
Un objeto de unidad representa una unidad de cinta o unidad de disco. El miembro Info es un puntero a una estructura de NTMS_DRIVEINFORMATION . |
|
Se crea un objeto de tipo de unidad para cada tipo de dispositivo de unidad único conectado a un sistema. El miembro Info es un puntero a una estructura de NTMS_DRIVETYPEINFORMATION . |
|
Un objeto NTMS_IEDOOR representa el mecanismo de acceso a la puerta de una unidad de biblioteca. El miembro Info es un puntero a una estructura de NTMS_IEDOORINFORMATION . |
|
Un objeto NTMS_IEPORT representa el puerto de inserción y expulsión de una unidad de biblioteca. El miembro Info es un puntero a una estructura de NTMS_IEPORTINFORMATION . |
|
Un objeto de biblioteca representa una biblioteca en línea o sin conexión. El miembro Info es un puntero a una estructura de NTMS_LIBRARYINFORMATION . |
|
Se crea un objeto de solicitud de biblioteca para cada solicitud de una biblioteca para realizar una acción. RSM mantiene una lista de solicitudes de biblioteca como una cola de trabajo que se va a realizar. El miembro Info es un puntero a una estructura de NTMS_LIBREQUESTINFORMATION . |
|
Identificador principal que usan las aplicaciones para acceder al medio especificado. En el caso de medios de varios lados, cada lado se trata como un fragmento individual de medios físicos. El miembro Info es un puntero a una estructura de NTMS_LMIDINFORMATION . |
|
Un grupo de medios es una agrupación lógica de medios. Todos los medios de un grupo de medios deben ser el mismo tipo de medio. El miembro Info es un puntero a una estructura de NTMS_MEDIAPOOLINFORMATION . |
|
Se crea un objeto de tipo multimedia para cada tipo de medio único en un sistema. El miembro Info es un puntero a una estructura de NTMS_MEDIATYPEINFORMATION . |
|
Un objeto de solicitud de operador representa una solicitud de RSM para que un usuario obtenga la información. El miembro Info es un puntero a una estructura de NTMS_OPREQUESTINFORMATION . |
|
Un objeto lateral representa un lado de un fragmento de medio físico. El miembro Info es un puntero a una estructura de NTMS_PARTITIONINFORMATION . |
|
Un objeto multimedia físico representa una cinta magnética o un disco extraíble. Un fragmento de medios físicos puede contener uno o varios lados. El miembro Info es un puntero a una estructura de NTMS_PMIDINFORMATION . |
|
Un objeto de ranura de almacenamiento representa una de las ranuras que pueden contener el medio especificado en una biblioteca. El miembro Info es un puntero a una estructura de NTMS_STORAGESLOTINFORMATION . |
Created
Tipo: SYSTEMTIME
Marca de fecha y hora cuando se creó el objeto.
Modified
Tipo: SYSTEMTIME
Marca de fecha y hora cuando se modificó el objeto.
ObjectGuid
Tipo: NTMS_GUID
GUID del objeto.
Enabled
Tipo: BOOL
Indica si el objeto de control del dispositivo o del sistema está habilitado.
dwOperationalState
Tipo: DWORD
Define el estado operativo actual del objeto . Puede ser uno de los siguientes valores.
szName[NTMS_OBJECTNAME_LENGTH]
Tipo: TCHAR[NTMS_OBJECTNAME_LENGTH]
Nombre del objeto de control multimedia, dispositivo o sistema. El grupo de medios y los nombres de medios lógicos se pueden cambiar mediante la función SetNtmsObjectInformation . Todos los demás nombres de objeto son de solo lectura.
szDescription[NTMS_DESCRIPTION_LENGTH]
Tipo: TCHAR[NTMS_DESCRIPTION_LENGTH]
Descripción del objeto de control del dispositivo o del sistema. La descripción de los objetos de control del dispositivo y del sistema se puede cambiar mediante la función SetNtmsObjectInformation . (Grabable para todos los objetos)
Info
Información específica del objeto de control del dispositivo o del sistema. El formato de esta información depende del miembro dwType .
Info.Drive
Tipo: NTMS_DRIVEINFORMATION Este formato se usa si el valor dwType es NTMS_DRIVE.
Info.DriveType
Tipo: NTMS_DRIVETYPEINFORMATION Este formato se usa si el valor dwType es NTMS_DRIVE_TYPE.
Info.Library
Tipo: NTMS_LIBRARYINFORMATION Este formato se usa si el valor dwType es NTMS_LIBRARY.
Info.Changer
Tipo: NTMS_CHANGERINFORMATION Este formato se usa si el valor dwType es NTMS_CHANGER.
Info.ChangerType
Tipo: NTMS_CHANGERTYPEINFORMATION Este formato se usa si el valor dwType es NTMS_CHANGER_TYPE.
Info.StorageSlot
Tipo: NTMS_STORAGESLOTINFORMATION Este formato se usa si el valor dwType es NTMS_STORAGESLOT.
Info.IEDoor
Tipo: NTMS_IEDOORINFORMATION Este formato se usa si el valor dwType es NTMS_IEDOOR.
Info.IEPort
Tipo: NTMS_IEPORTINFORMATION Este formato se usa si el valor dwType es NTMS_IEPORT.
Info.PhysicalMedia
Tipo: NTMS_PMIDINFORMATION Este formato se usa si el valor dwType es NTMS_PHYSICAL_MEDIA.
Info.LogicalMedia
Tipo: NTMS_LMIDINFORMATION Este formato se usa si el valor dwType es NTMS_LOGICAL_MEDIA.
Info.Partition
Tipo: NTMS_PARTITIONINFORMATION Este formato se usa si el valor dwType es NTMS_PARTITION.
Info.MediaPool
Tipo: NTMS_MEDIAPOOLINFORMATION Este formato se usa si el valor dwType es NTMS_MEDIA_POOL.
Info.MediaType
Tipo: NTMS_MEDIATYPEINFORMATION Este formato se usa si el valor dwType es NTMS_MEDIA_TYPE.
Info.LibRequest
Tipo: NTMS_LIBREQUESTINFORMATION Este formato se usa si el valor dwType es NTMS_LIBREQUEST.
Info.OpRequest
Tipo: NTMS_OPREQUESTINFORMATION Este formato se usa si el valor dwType es NTMS_OPREQUEST.
Info.Computer
Comentarios
Todos los miembros de la estructura de NTMS_OBJECTINFORMATION son de solo lectura en el nivel de función de RSM, a menos que se especifique como WRITABLE en la definición del miembro.
Nota
El encabezado ntmsapi.h define NTMS_OBJECTINFORMATION 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 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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de