Função InventoryNtmsLibrary (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 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