Función ReserveNtmsCleanerSlot (ntmsapi.h)
[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]
La función ReserveNtmsCleanerSlot reserva una sola ranura en una unidad de biblioteca para un cartucho limpiador de unidades.
Sintaxis
DWORD ReserveNtmsCleanerSlot(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpLibrary,
[in] LPNTMS_GUID lpSlot
);
Parámetros
[in] hSession
Identificador de la sesión devuelta por la función OpenNtmsSession .
[in] lpLibrary
Identificador único de la biblioteca para reservar la ranura más limpia.
[in] lpSlot
Identificador único de la ranura que se va a reservar para un cartucho más limpio.
Valor devuelto
Esta función devuelve uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
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. |
|
Esta ranura u otra ranura de la biblioteca ya se ha reservado para la limpieza. Para cambiar la ranura del cartucho más limpio, primero se debe liberar la ranura de limpiador reservada, utilizando la función ReleaseNtmsCleanerSlot . |
|
La biblioteca no está conectada actualmente. |
|
El valor especificado en el parámetro hSession no es válido. |
|
No se puede recuperar la definición de ranura de la base de datos. |
|
No se puede conectar al servicio RSM. |
|
No hay ninguna ranura de limpiador reservada. La ranura especificada tiene medios en él. La reserva solo se puede realizar en un espacio vacío. |
|
No hay ninguna ranura de limpiador reservada. La ranura especificada no está instalada actualmente en la biblioteca. Este error se produce si falta al menos un cargador de cartuchos de la biblioteca. |
|
La función se puso en cola correctamente. |
Comentarios
La ranura reservada con la función ReserveNtmsCleanerSlot debe estar presente y vacía. La biblioteca aún no debe tener una ranura reservada para un cartucho más limpio.
Requisitos
| 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 |