estrutura NTMS_LIBRARYINFORMATION (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_LIBRARYINFORMATION define propriedades específicas de um objeto de biblioteca.

Sintaxe

typedef struct _NTMS_LIBRARYINFORMATION {
  DWORD     LibraryType;
  NTMS_GUID CleanerSlot;
  NTMS_GUID CleanerSlotDefault;
  BOOL      LibrarySupportsDriveCleaning;
  BOOL      BarCodeReaderInstalled;
  DWORD     InventoryMethod;
  DWORD     dwCleanerUsesRemaining;
  DWORD     FirstDriveNumber;
  DWORD     dwNumberOfDrives;
  DWORD     FirstSlotNumber;
  DWORD     dwNumberOfSlots;
  DWORD     FirstDoorNumber;
  DWORD     dwNumberOfDoors;
  DWORD     FirstPortNumber;
  DWORD     dwNumberOfPorts;
  DWORD     FirstChangerNumber;
  DWORD     dwNumberOfChangers;
  DWORD     dwNumberOfMedia;
  DWORD     dwNumberOfMediaTypes;
  DWORD     dwNumberOfLibRequests;
  GUID      Reserved;
  BOOL      AutoRecovery;
  DWORD     dwFlags;
} NTMS_LIBRARYINFORMATION;

Membros

LibraryType

Objeto de tipo de biblioteca. Esse pode ser um dos valores a seguir.

Valor	Significado
NTMS_LIBRARYTYPE_ONLINE	Um elemento robótico que automatiza a montagem e desmontagem de mídia em uma ou mais unidades.
NTMS_LIBRARYTYPE_STANDALONE	Uma unidade autônoma que é modelada como uma biblioteca com uma unidade no RSM.
NTMS_LIBRARYTYPE_OFFLINE	A mídia que não está em uma biblioteca está na biblioteca offline.
NTMS_LIBRARYTYPE_UNKNOWN	O tipo de biblioteca não pode ser determinado.

CleanerSlot

Para cada biblioteca, isso representa o slot atribuído ao cartucho mais limpo. Se esse membro for NULL, não haverá nenhum slot mais limpo definido para essa biblioteca.

CleanerSlotDefault

Representa o slot de limpeza padrão ou preferencial de uma biblioteca. Se FOR NULL, não haverá um slot preferencial.

LibrarySupportsDriveCleaning

Usado por unidades que exigem limpeza sob controle de robótica. Se TRUE, as operações de limpeza automática de unidade serão habilitadas.

BarCodeReaderInstalled

Retornará TRUE se um leitor de código de barras estiver instalado em uma biblioteca; caso contrário, retornará FALSE.

InventoryMethod

Método padrão ou selecionado pelo usuário para executar o inventário desta biblioteca. (Este membro é gravável.) Esse pode ser um dos valores a seguir.

Valor	Significado
NTMS_INVENTORY_FAST	Se a biblioteca tiver um leitor de código de barras instalado, esse valor fará com que um inventário de código de barras seja executado. Se a biblioteca não tiver um leitor de código de barras, esse sinalizador fará com que um inventário diferencial seja executado (slots que passaram de vazio para completo são classificados).
NTMS_INVENTORY_OMID	Um inventário completo envolve montar cada lado em uma biblioteca e ler a identificação na mídia da mídia. Esse tipo de inventário pode ser muito demorado para algumas unidades de biblioteca.
NTMS_INVENTORY_NONE	Depois que a porta da biblioteca é fechada, nenhum inventário é executado. O inventário poderá ser necessário se um rótulo de montagem marcar falhar.

dwCleanerUsesRemaining

Número de usos restantes no limpador na biblioteca. Esse membro será zero se nenhum limpador estiver presente ou se a biblioteca não der suporte à limpeza.

FirstDriveNumber

Número da primeira unidade na biblioteca.

dwNumberOfDrives

Número de unidades na biblioteca.

FirstSlotNumber

Número do primeiro slot na biblioteca.

dwNumberOfSlots

Número de slots na biblioteca.

FirstDoorNumber

Número da primeira porta de acesso na biblioteca.

dwNumberOfDoors

Número de portas de acesso na biblioteca.

FirstPortNumber

Número da primeira porta de inserção/ejeção na biblioteca.

dwNumberOfPorts

Número de portas de inserção/ejeção na biblioteca.

FirstChangerNumber

Número do primeiro alterador na biblioteca.

dwNumberOfChangers

Número de alteradores na biblioteca.

dwNumberOfMedia

Número de mídias na biblioteca online ou offline.

dwNumberOfMediaTypes

Número de tipos de mídia compatíveis com a biblioteca.

dwNumberOfLibRequests

Número de solicitações de biblioteca atuais.

Reserved

Reservado.

AutoRecovery

Se esse membro for TRUE, um inventário completo será executado se uma montagem falhar. A falha pode ser incompatibilidade de hardware ou rótulo. Para bibliotecas de CD da ATAPI, esse parâmetro não pode ser desabilitado. O valor padrão é TRUE. Os proprietários de bibliotecas grandes devem desabilitar esse recurso.

dwFlags

Esse membro pode ser um ou mais dos valores a seguir.

Valor	Significado
NTMS_LIBRARYFLAG_FIXEDOFFLINE	A biblioteca é uma biblioteca offline, não uma biblioteca que não está presente.
NTMS_LIBRARYFLAG_CLEANERPRESENT	Um limpador está presente no divisor de águas.
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING	O cartucho mais limpo será usado até que não limpe mais a unidade, em vez de manter o controle do número de limpezas restantes. Não defina esse sinalizador diretamente. Ele é definido ou limpo com base no valor de dwCleanerUsesRemaining. Ele será definido se dwCleanerUsesRemaining for 0xFFFFFFFF e limpo de outra forma.
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE	Trate cartuchos de código de barras que tenham CLN como prefixo como cartuchos mais limpos, em vez de montá-los na unidade para identificá-los.

Comentários

Para bibliotecas offline, somente LibraryType e dwNumberOfMedia são relatados. Todos os outros valores devem ser ignorados.

A estrutura NTMS_LIBRARYINFORMATION está incluída na estrutura NTMS_OBJECTINFORMATION .

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

NTMS_OBJECTINFORMATION