DismountNtmsDrive-Funktion (ntmsapi.h)

  • Artikel

[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