Função CleanNtmsDrive (ntmsapi.h)
[O Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]
A função CleanNtmsDrive enfileira uma solicitação de limpeza para a unidade especificada para limpeza.
Sintaxe
DWORD CleanNtmsDrive(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpDriveId
);
Parâmetros
[in] hSession
Manipule para a sessão retornada pela função OpenNtmsSession .
[in] lpDriveId
Identificador exclusivo da unidade a ser limpa.
Retornar valor
Essa função retorna um dos valores a seguir.
| Valor | Significado |
|---|---|
|
NTMS_CONTROL_ACCESS para a biblioteca é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança. |
|
O banco de dados está inacessível ou danificado. |
|
O banco de dados está cheio. |
|
A ID da unidade não é válida. |
|
O identificador de sessão está ausente ou não é válido. |
|
A biblioteca da unidade não é válida. |
|
A ID da unidade está ausente. |
|
Ocorreu uma falha de alocação durante o processamento. |
|
A unidade ou a biblioteca não está habilitada. |
|
A limpeza foi enfileirada com êxito. |
Comentários
Se a unidade selecionada na função CleanNtmsDrive for uma unidade autônoma, a unidade será marcada como limpa e o tempo será observado no Banco de Dados RSM.
As solicitações de limpeza enfileiradas são excluídas quando o serviço é reiniciado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ntmsapi.h |
| Biblioteca | Ntmsapi.lib |
| DLL | Ntmsapi.dll |