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