NTMS_OBJECTINFORMATIONA estrutura (ntmsapi.h)

Artigo
11/20/2024

[Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]

A estrutura NTMS_OBJECTINFORMATION define as propriedades que um aplicativo pode obter e definir para dispositivos RSM, controles de mídia e sistema (como bibliotecas, unidades, mídia, solicitações de operador). Essa é a estrutura comum de objetos no banco de dados RSM.

Sintaxe

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;

Membros

dwSize

Tipo: DWORD

Tamanho da estrutura de informações, em bytes. Esse membro deve ser definido como o tamanho correto da estrutura antes de usar a função GetNtmsObjectInformation ou a função SetNtmsObjectInformation.

dwType

Tipo: DWORD

Tipo de dispositivo ou controle do sistema para o qual obter/definir informações. Esse membro deve ser definido como um dos valores a seguir.

Valor	Significado
NTMS_CHANGER	Um objeto changer representa o elemento robótico de uma unidade de biblioteca. O membro informações é um ponteiro para uma estrutura de NTMS_CHANGERINFORMATION.
NTMS_CHANGER_TYPE	Um objeto de tipo de alterador é criado para cada tipo de dispositivo de alteração exclusivo anexado a um sistema. O membro informações do é um ponteiro para uma estrutura de NTMS_CHANGERTYPEINFORMATION.
NTMS_COMPUTER	O objeto de computador atual. Não há estrutura para o objeto de computador. O membro informações do é um ponteiro para uma estrutura de NTMS_COMPUTERINFORMATION.
NTMS_DRIVE	Um objeto de unidade representa uma unidade de fita ou unidade de disco. O membro Info é um ponteiro para uma estrutura de NTMS_DRIVEINFORMATION.
NTMS_DRIVE_TYPE	Um objeto de tipo de unidade é criado para cada tipo de dispositivo de unidade exclusivo anexado a um sistema. O membro de Informações do é um ponteiro para uma estrutura de NTMS_DRIVETYPEINFORMATION.
NTMS_IEDOOR	Um objeto NTMS_IEDOOR representa o mecanismo de acesso à porta de uma unidade de biblioteca. O membro Info é um ponteiro para uma estrutura de NTMS_IEDOORINFORMATION.
NTMS_IEPORT	Um objeto NTMS_IEPORT representa a porta de inserção/ejeção de uma unidade de biblioteca. O membro informações do é um ponteiro para uma estrutura de NTMS_IEPORTINFORMATION.
NTMS_LIBRARY	Um objeto de biblioteca representa uma biblioteca online ou offline. O membro Info é um ponteiro para uma estrutura de NTMS_LIBRARYINFORMATION.
NTMS_LIBREQUEST	Um objeto de solicitação de biblioteca é criado para cada solicitação para que uma biblioteca execute uma ação. Uma lista de solicitações de biblioteca é mantida pelo RSM como uma fila de trabalho a ser executada. O membro Info é um ponteiro para uma estrutura NTMS_LIBREQUESTINFORMATION.
NTMS_LOGICAL_MEDIA	O identificador primário usado pelos aplicativos para acessar o meio especificado. No caso de mídia multi-lado, cada lado é tratado como uma parte individual da mídia física. O membro de Informações do é um ponteiro para uma estrutura NTMS_LMIDINFORMATION.
NTMS_MEDIA_POOL	Um pool de mídia é um agrupamento lógico de mídia. Todas as mídias em um pool de mídia devem ser do mesmo tipo de mídia. O membro informações do é um ponteiro para uma estrutura de NTMS_MEDIAPOOLINFORMATION.
NTMS_MEDIA_TYPE	Um objeto de tipo de mídia é criado para cada tipo de mídia exclusivo em um sistema. O membro Info é um ponteiro para uma estrutura NTMS_MEDIATYPEINFORMATION.
NTMS_OPREQUEST	Um objeto de solicitação de operador representa uma solicitação RSM para um usuário obter as informações. O membro informações do é um ponteiro para uma estrutura NTMS_OPREQUESTINFORMATION.
NTMS_PARTITION	Um objeto lateral representa um lado de um pedaço de mídia física. O membro informações do é um ponteiro para uma estrutura de NTMS_PARTITIONINFORMATION.
NTMS_PHYSICAL_MEDIA	Um objeto de mídia física representa uma fita magnética ou um disco removível. Um pedaço de mídia física pode conter um ou mais lados. O membro informações do é um ponteiro para uma estrutura de NTMS_PMIDINFORMATION.
NTMS_STORAGESLOT	Um objeto de slot de armazenamento representa um dos slots que podem conter o meio especificado em uma biblioteca. O membro Info é um ponteiro para uma estrutura de NTMS_STORAGESLOTINFORMATION.

Created

Tipo: SYSTEMTIME

Carimbo de data/hora quando o objeto foi criado.

Modified

Tipo: SYSTEMTIME

Carimbo de data/hora quando o objeto foi modificado.

ObjectGuid

Tipo: NTMS_GUID

GUID do objeto.

Enabled

Tipo: BOOL

Indica se o dispositivo ou objeto de controle do sistema está habilitado.

dwOperationalState

Tipo: DWORD

Define o estado operacional atual do objeto. Esse pode ser um dos valores a seguir.

Valor	Significado
NTMS_NOT_PRESENT	Este dispositivo ou objeto não está presente no momento.
NTMS_READY	Este dispositivo ou objeto está disponível e pronto.
NTMS_NEEDS_SERVICE	Esse dispositivo ou objeto falhou e precisa de serviço.

szName[NTMS_OBJECTNAME_LENGTH]

Tipo: TCHAR[NTMS_OBJECTNAME_LENGTH]

Nome do objeto de controle de mídia, dispositivo ou sistema. O pool de mídia e os nomes de mídia lógica podem ser alterados usando a função SetNtmsObjectInformation. Todos os outros nomes de objeto são somente leitura.

szDescription[NTMS_DESCRIPTION_LENGTH]

Tipo: TCHAR[NTMS_DESCRIPTION_LENGTH]

Descrição do dispositivo ou objeto de controle do sistema. A descrição dos objetos de controle do dispositivo e do sistema pode ser alterada usando a função SetNtmsObjectInformation. (Gravável para todos os objetos)

Info

Informações específicas do objeto de controle do dispositivo ou do sistema. O formato dessas informações depende do membro dwType.

Info.Drive

Tipo: NTMS_DRIVEINFORMATION Esse formato será usado se o valor dwType for NTMS_DRIVE.

Info.DriveType

Tipo: NTMS_DRIVETYPEINFORMATION Esse formato será usado se o valor dwType for NTMS_DRIVE_TYPE.

Info.Library

Tipo: NTMS_LIBRARYINFORMATION Esse formato será usado se o valor dwType for NTMS_LIBRARY.

Info.Changer

Tipo: NTMS_CHANGERINFORMATION Esse formato será usado se o valor dwType for NTMS_CHANGER.

Info.ChangerType

Tipo: NTMS_CHANGERTYPEINFORMATION Esse formato será usado se o valor dwType for NTMS_CHANGER_TYPE.

Info.StorageSlot

Tipo: NTMS_STORAGESLOTINFORMATION Esse formato será usado se o valor dwType for NTMS_STORAGESLOT.

Info.IEDoor

Tipo: NTMS_IEDOORINFORMATION Esse formato será usado se o valor dwType for NTMS_IEDOOR.

Info.IEPort

Tipo: NTMS_IEPORTINFORMATION Esse formato será usado se o valor dwType for NTMS_IEPORT.

Info.PhysicalMedia

Tipo: NTMS_PMIDINFORMATION Esse formato será usado se o valor dwType for NTMS_PHYSICAL_MEDIA.

Info.LogicalMedia

Tipo: NTMS_LMIDINFORMATION Esse formato será usado se o valor dwType for NTMS_LOGICAL_MEDIA.

Info.Partition

Tipo: NTMS_PARTITIONINFORMATION Esse formato será usado se o valor dwType for NTMS_PARTITION.

Info.MediaPool

Tipo: NTMS_MEDIAPOOLINFORMATION Esse formato será usado se o valor dwType for NTMS_MEDIA_POOL.

Info.MediaType

Tipo: NTMS_MEDIATYPEINFORMATION Esse formato será usado se o valor dwType for NTMS_MEDIA_TYPE.

Info.LibRequest

Tipo: NTMS_LIBREQUESTINFORMATION Esse formato será usado se o valor dwType for NTMS_LIBREQUEST.

Info.OpRequest

Tipo: NTMS_OPREQUESTINFORMATION Esse formato será usado se o valor dwType for NTMS_OPREQUEST.

Info.Computer

Observações

Todos os membros da estrutura NTMS_OBJECTINFORMATION são somente leitura no nível da função RSM, a menos que especificados como WRITABLE na definição do membro.

Nota

O cabeçalho ntmsapi.h define NTMS_OBJECTINFORMATION como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	ntmsapi.h

Consulte também

GetNtmsObjectInformation

SetNtmsObjectInformation

Compartilhar via

NTMS_OBJECTINFORMATIONA estrutura (ntmsapi.h)

Sintaxe

Membros

Observações

Requisitos

Consulte também

Comentários

Recursos adicionais