estrutura NTMS_OBJECTINFORMATIONW (ntmsapi.h)
[O Gerenciador de Armazenamento Removível não está mais disponível desde o Windows 7 e o 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_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;
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 |
|---|---|
|
Um objeto changer representa o elemento robótico de uma unidade de biblioteca. O membro Info é um ponteiro para uma estrutura NTMS_CHANGERINFORMATION . |
|
Um objeto de tipo de alterador é criado para cada tipo de dispositivo de alterador exclusivo anexado a um sistema. O membro Info é um ponteiro para uma estrutura NTMS_CHANGERTYPEINFORMATION . |
|
O objeto de computador atual. Não há nenhuma estrutura para o objeto de computador. O membro Info é um ponteiro para uma estrutura NTMS_COMPUTERINFORMATION . |
|
Um objeto de unidade representa uma unidade de fita ou unidade de disco. O membro Info é um ponteiro para uma estrutura NTMS_DRIVEINFORMATION . |
|
Um objeto de tipo de unidade é criado para cada tipo de dispositivo de unidade exclusivo anexado a um sistema. O membro Info é um ponteiro para uma estrutura NTMS_DRIVETYPEINFORMATION . |
|
Um objeto NTMS_IEDOOR representa o mecanismo de acesso à porta de uma unidade de biblioteca. O membro Info é um ponteiro para uma estrutura NTMS_IEDOORINFORMATION . |
|
Um objeto NTMS_IEPORT representa a porta de inserção/ejeção de uma unidade de biblioteca. O membro Info é um ponteiro para uma estrutura NTMS_IEPORTINFORMATION . |
|
Um objeto de biblioteca representa uma biblioteca online ou offline. O membro Info é um ponteiro para uma estrutura NTMS_LIBRARYINFORMATION . |
|
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 . |
|
O identificador primário usado pelos aplicativos para acessar o meio especificado. No caso de mídia de vários lados, cada lado é tratado como uma parte individual da mídia física. O membro Info é um ponteiro para uma estrutura NTMS_LMIDINFORMATION . |
|
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 Info é um ponteiro para uma estrutura NTMS_MEDIAPOOLINFORMATION . |
|
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 . |
|
Um objeto de solicitação de operador representa uma solicitação RSM para um usuário obter as informações. O membro Info é um ponteiro para uma estrutura NTMS_OPREQUESTINFORMATION . |
|
Um objeto lateral representa um lado de uma parte da mídia física. O membro Info é um ponteiro para uma estrutura NTMS_PARTITIONINFORMATION . |
|
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 Info é um ponteiro para uma estrutura NTMS_PMIDINFORMATION . |
|
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 NTMS_STORAGESLOTINFORMATION . |
Created
Tipo: SYSTEMTIME
Carimbo de data/hora quando o objeto foi criado.
Modified
Tipo: SYSTEMTIME
Carimbo de data/hora em que 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.
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
Comentários
Todos os membros da estrutura NTMS_OBJECTINFORMATION são somente leitura no nível da função RSM, a menos que especificado como WRITABLE na definição do membro.
Observação
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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | ntmsapi.h |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de