Función CancelNtmsLibraryRequest (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 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