Compartilhar via

Função InventoryNtmsLibrary (ntmsapi.h)

  • Artigo

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

A função InventoryNtmsLibrary enfileira um inventário da biblioteca especificada. Se a biblioteca estiver ocupada, o RSM colocará em fila InventoryNtmsLibrary e retornará êxito.

Sintaxe

DWORD InventoryNtmsLibrary(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

Parâmetros

[in] hSession

Identificador para a sessão retornada pela função OpenNtmsSession .

[in] lpLibraryId

Identificador exclusivo de um objeto de biblioteca.

[in] dwAction

Ação a ser executada. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
NTMS_INVENTORY_OMID
 Um inventário completo na mídia é executado. Cada lado de cada meio deve ser montado em uma unidade. Esse é um processo demorado.
NTMS_INVENTORY_FAST
 Se a biblioteca tiver um leitor de código de barras instalado, esse sinalizador 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 (os slots são classificados).
NTMS_INVENTORY_DEFAULT
 Use o InventoryMethod especificado no objeto de biblioteca (consulte NTMS_LIBRARYINFORMATION).
NTMS_INVENTORY_STOP
 Interrompa o inventário atual na biblioteca especificada.

Retornar valor

Essa função retorna um dos valores a seguir.

Valor Significado
ERROR_ACCESS_DENIED
 O acesso a um ou mais objetos RSM foi negado.
ERROR_DEVICE_NOT_AVAILABLE
 A biblioteca não está conectada no momento.
ERROR_INVALID_HANDLE
 O valor especificado no parâmetro hSession não é válido.
ERROR_INVALID_LIBRARY
 A biblioteca é a biblioteca offline.
ERROR_INVALID_PARAMETER
 A ID da biblioteca ou a ID da sessão não é válida.
ERROR_NOT_CONNECTED
 Não é possível se conectar ao serviço RSM.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

As bibliotecas não presentes não podem ser inventariadas.

A função InventoryNtmsLibrary marca todos os slots que atualmente contêm um meio na biblioteca para classificação/identificação. A função InventoryNtmsLibrary retorna quando toda a mídia é marcada.

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]
Plataforma de Destino Windows
Cabeçalho ntmsapi.h
Biblioteca Ntmsapi.lib
DLL Ntmsapi.dll

Confira também

AccessNtmsLibraryDoor

Funções de controle de biblioteca