Función InventoryNtmsLibrary (ntmsapi.h)

  • Artículo

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función InventoryNtmsLibrary pone en cola un inventario de la biblioteca especificada. Si la biblioteca está ocupada, RSM pone en cola InventoryNtmsLibrary y devuelve el éxito.

Sintaxis

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

Parámetros

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] lpLibraryId

Identificador único de un objeto de biblioteca.

[in] dwAction

Acción que se va a realizar. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
NTMS_INVENTORY_OMID
 Se realiza un inventario completo en medios. Cada lado de cada medio debe montarse en una unidad. Se trata de un proceso lento.
NTMS_INVENTORY_FAST
 Si la biblioteca tiene instalado un lector de código de barra, esta marca hace que se realice un inventario de código de barras. Si la biblioteca no tiene un lector de código de barra, esta marca hace que se realice un inventario diferencial (las ranuras se clasifican).
NTMS_INVENTORY_DEFAULT
 Use inventoryMethod especificado en el objeto de biblioteca (vea NTMS_LIBRARYINFORMATION).
NTMS_INVENTORY_STOP
 Detenga el inventario actual en la biblioteca especificada.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 Se deniega el acceso a uno o varios objetos RSM.
ERROR_DEVICE_NOT_AVAILABLE
 La biblioteca no está conectada actualmente.
ERROR_INVALID_HANDLE
 El valor especificado en el parámetro hSession no es válido.
ERROR_INVALID_LIBRARY
 La biblioteca es la biblioteca sin conexión.
ERROR_INVALID_PARAMETER
 El identificador de biblioteca o el identificador de sesión no son válidos.
ERROR_NOT_CONNECTED
 No se puede conectar al servicio RSM.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

No se pueden inventariar bibliotecas no presentes.

La función InventoryNtmsLibrary marca todas las ranuras que contienen actualmente un medio en la biblioteca para la clasificación o identificación. La función InventoryNtmsLibrary devuelve cuando todos los medios están marcados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntmsapi.h
Library Ntmsapi.lib
Archivo DLL Ntmsapi.dll

Consulte también

AccessNtmsLibraryDoor

Funciones de control de biblioteca