Función CancelNtmsLibraryRequest (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 CancelNtmsLibraryRequest cancela las solicitudes de RSM pendientes, como las llamadas a la función CleanNtmsDrive . Si la biblioteca está ocupada, RSM pone en cola la cancelación y devuelve el éxito.

Sintaxis

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

Parámetros

[in] hSession

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

[in] lpRequestId

Identificador único de la solicitud de biblioteca que se va a cancelar.

Para recuperar la lista de solicitudes de biblioteca existentes, use la función EnumerateNtmsObject .

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 Solo un administrador del servidor RSM puede cancelar las solicitudes de biblioteca. Este error también se devuelve si la solicitud se está administrando actualmente y no se puede eliminar.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_NOT_ENOUGH_MEMORY
 Se produjo un error de asignación durante el procesamiento.
ERROR_OBJECT_NOT_FOUND
 No se encontró el identificador de objeto de solicitud de biblioteca. Este error se produce si la solicitud se completa antes de emitir la cancelación o cuando se especifica un identificador de solicitud que no es válido.
ERROR_SUCCESS
 La solicitud de biblioteca se ha puesto en cola para la cancelación.

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

EnumerateNtmsObject

Funciones de control de biblioteca