Función CleanNtmsDrive (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 CleanNtmsDrive pone en cola una solicitud de limpieza para la unidad especificada para la limpieza.

Sintaxis

DWORD CleanNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

Parámetros

[in] hSession

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

[in] lpDriveId

Identificador único de la unidad que se va a limpiar.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor	Significado
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS a la biblioteca se deniega. También se pueden producir otros errores de seguridad, pero indicarían un error del subsistema de seguridad.
ERROR_DATABASE_FAILURE	La base de datos no es accesible o está dañada.
ERROR_DATABASE_FULL	La base de datos está llena.
ERROR_INVALID_DRIVE	El identificador de unidad no es válido.
ERROR_INVALID_HANDLE	Falta el identificador de sesión o no es válido.
ERROR_INVALID_LIBRARY	La biblioteca de la unidad no es válida.
ERROR_INVALID_PARAMETER	Falta el identificador de unidad.
ERROR_NOT_ENOUGH_MEMORY	Error de asignación durante el procesamiento.
ERROR_RESOURCE_DISABLED	La unidad o la biblioteca no están habilitadas.
ERROR_SUCCESS	La limpieza se puso en cola correctamente.

Comentarios

Si la unidad seleccionada en la función CleanNtmsDrive es una unidad independiente, la unidad se marca como limpia y la hora se indica en la base de datos de RSM.

Las solicitudes de limpieza en cola se eliminan cuando se reinicia el servicio.

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

Funciones de administración de limpiadores

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot

ReserveNtmsCleanerSlot