CleanNtmsDrive-Funktion (ntmsapi.h)

[Wechseldatenträger-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die CleanNtmsDrive-Funktion stellt eine Bereinigungsanforderung für das angegebene Laufwerk für die Reinigung in die Warteschlange.

Syntax

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

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] lpDriveId

Eindeutiger Bezeichner des zu bereinigenden Laufwerks.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS der Bibliothek wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Sicherheitssubsystemfehler hinweisen würden.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt.
ERROR_DATABASE_FULL	Die Datenbank ist voll.
ERROR_INVALID_DRIVE	Die Laufwerks-ID ist ungültig.
ERROR_INVALID_HANDLE	Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_LIBRARY	Die Bibliothek für das Laufwerk ist ungültig.
ERROR_INVALID_PARAMETER	Die Laufwerks-ID fehlt.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_RESOURCE_DISABLED	Das Laufwerk oder die Bibliothek ist nicht aktiviert.
ERROR_SUCCESS	Die Reinigung wurde erfolgreich in die Warteschlange gestellt.

Hinweise

Wenn das Laufwerk, das Sie in der CleanNtmsDrive-Funktion ausgewählt haben, ein eigenständiges Laufwerk ist, wird das Laufwerk als bereinigt markiert, und die Uhrzeit wird in der RSM-Datenbank notiert.

Bereinigungsanforderungen in der Warteschlange werden gelöscht, wenn der Dienst neu gestartet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntmsapi.h
Bibliothek	Ntmsapi.lib
DLL	Ntmsapi.dll

Weitere Informationen

Sauberere Verwaltungsfunktionen

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot

ReserveNtmsCleanerSlot