Compartir a través de

Función AccessNtmsLibraryDoor (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 AccessNtmsLibraryDoor desbloquea la puerta de la biblioteca especificada. Si la biblioteca está ocupada, RSM pone en cola la solicitud y devuelve correctamente.

Sintaxis

DWORD AccessNtmsLibraryDoor(
  [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 del objeto de biblioteca. Esta biblioteca debe admitir el acceso a las puertas.

[in] dwAction

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

Valor Significado
NTMS_INVENTORY_NONE
 Una vez que el usuario cierra la puerta, no se realiza ningún inventario. Sin embargo, si se produce un error en una comprobación de la etiqueta de montaje, se realizará un inventario.
NTMS_INVENTORY_OMID
 Una vez que el usuario cierra la puerta, se realiza un inventario completo de medios. Esto puede llevar mucho tiempo porque cada lado de cada medio debe montarse.
NTMS_INVENTORY_FAST
 Si la biblioteca tiene instalado un lector de código de barra, esta marca hace que se realice el 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. Los OMID se comprueban en cada medio colocado en una ranura vacía mientras la puerta está abierta.
NTMS_INVENTORY_DEFAULT
 Use inventoryMethod especificado en el objeto de biblioteca (vea NTMS_LIBRARYINFORMATION).

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS a la biblioteca se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.
ERROR_DATABASE_FAILURE
 La base de datos es inaccesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_PARAMETER
 Falta el identificador de biblioteca.
ERROR_LIBRARY_OFFLINE
 El identificador de biblioteca hace referencia a una biblioteca sin conexión sin puerta.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_RESOURCE_DISABLED
 La biblioteca está deshabilitada.
ERROR_RESOURCE_NOT_PRESENT
 La biblioteca no tiene una puerta.
ERROR_SUCCESS
 El acceso a la puerta está en cola.

Comentarios

Algunas bibliotecas no proporcionan ningún medio para que RSM bloquee y desbloquee sus puertas mediante programación. El comportamiento de esta función con estas bibliotecas es idéntico a su comportamiento con bibliotecas que RSM puede desbloquear y bloquear.

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

EjectNtmsMedia

InjectNtmsMedia

Funciones de control de biblioteca