Funzione CleanNtmsDrive (ntmsapi.h)
[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]
La funzione CleanNtmsDrive accoda una richiesta di pulizia per l'unità specificata per la pulizia.
Sintassi
DWORD CleanNtmsDrive(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpDriveId
);
Parametri
[in] hSession
Handle per la sessione restituita dalla funzione OpenNtmsSession .
[in] lpDriveId
Identificatore univoco dell'unità da pulire.
Valore restituito
Questa funzione restituisce uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
NTMS_CONTROL_ACCESS alla libreria viene negata. Altri errori di sicurezza sono possibili, ma indicano un errore del sottosistema di sicurezza. |
|
Il database non è accessibile o danneggiato. |
|
Il database è pieno. |
|
L'ID unità non è valido. |
|
L'handle di sessione è mancante o non è valido. |
|
La libreria per l'unità non è valida. |
|
ID unità mancante. |
|
Si è verificato un errore di allocazione durante l'elaborazione. |
|
L'unità o la libreria non è abilitata. |
|
La pulizia è stata accodata correttamente. |
Commenti
Se l'unità selezionata nella funzione CleanNtmsDrive è un'unità autonoma, l'unità viene contrassegnata come pulita e l'ora viene annotata nel database RSM.
Le richieste di pulizia in coda vengono eliminate al riavvio del servizio.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ntmsapi.h |
| Libreria | Ntmsapi.lib |
| DLL | Ntmsapi.dll |