estructura NTMS_OBJECTINFORMATIONA (ntmsapi.h)

Artículo
08/25/2023

[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
NTMS_CHANGER	Un objeto changer representa el elemento robótico de una unidad de biblioteca. El miembro Info es un puntero a una estructura NTMS_CHANGERINFORMATION .
NTMS_CHANGER_TYPE	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 .
NTMS_COMPUTER	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 .
NTMS_DRIVE	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 .
NTMS_DRIVE_TYPE	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 .
NTMS_IEDOOR	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 .
NTMS_IEPORT	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 .
NTMS_LIBRARY	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 .
NTMS_LIBREQUEST	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 .
NTMS_LOGICAL_MEDIA	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 .
NTMS_MEDIA_POOL	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 .
NTMS_MEDIA_TYPE	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 .
NTMS_OPREQUEST	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 .
NTMS_PARTITION	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 .
NTMS_PHYSICAL_MEDIA	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 .
NTMS_STORAGESLOT	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.

Valor	Significado
NTMS_NOT_PRESENT	Este dispositivo o objeto no está presente actualmente.
NTMS_READY	Este dispositivo o objeto está disponible y listo.
NTMS_NEEDS_SERVICE	Este dispositivo o objeto ha producido un error y necesita servicio.

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

GetNtmsObjectInformation

SetNtmsObjectInformation

Compartir a través de

estructura NTMS_OBJECTINFORMATIONA (ntmsapi.h)

Sintaxis

Miembros

Comentarios

Requisitos

Consulte también

Comentarios

Recursos adicionales