DismountNtmsDrive-Funktion (ntmsapi.h)

Artikel
03/04/2024

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

Die Funktion DismountNtmsDrive stellt einen Befehl in die Warteschlange, um die Medien auf dem angegebenen Laufwerk in den zugehörigen Speicherslot zu verschieben. Diese Funktion sollte mit der MountNtmsMedia-Funktion gekoppelt werden.

Syntax

DWORD DismountNtmsDrive(
  [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 eines Laufwerkobjekts.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS an die Bibliothek wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten. Windows XP: NTMS_CONTROL_ACCESS der Bibliothek wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder beschädigt werden.
ERROR_DATABASE_FULL	Die Datenbank ist voll.
ERROR_DEVICE_NOT_AVAILABLE	Das Laufwerk oder die Bibliothek ist nicht aktiviert.
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_INVALID_STATE	Das Laufwerk enthält keine Medien.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Wenn das durch die DismountNtmsDrive-Funktion angegebene Laufwerk leer ist oder das Medium geöffnet wird, wird ein Fehler zurückgegeben. Andernfalls wird das Medium in seinen Slot zurückgegeben.

Heben Sie die Bereitstellung von Anforderungen für eigenständige Laufwerke auf, und legen Sie das Laufwerk in den nicht bereitstellbaren Zustand, und es wird ein Erfolg zurückgegeben.

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

Bibliothekssteuerungsfunktionen

Freigeben über