DismountNtmsMedia-Funktion (ntmsapi.h)

  • Artikel

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

Die DismountNtmsMedia-Funktion stellt einen Befehl in die Warteschlange, um die angegebenen Medien in einem Laufwerk in seinen Speicher zu verschieben. Diese Funktion sollte mit der MountNtmsMedia-Funktion gekoppelt werden.

Syntax

DWORD DismountNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       dwCount,
  [in] DWORD       dwOptions
);

Parameter

[in] hSession

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

[in] lpMediaId

Array aus mindestens einem logischen Medium oder einer Seite.

[in] dwCount

Anzahl der Medienbezeichner im lpMediaId-Parameter .

[in] dwOptions

Optionen. Dieser Parameter kann der folgende Wert sein.

Wert Bedeutung
NTMS_DISMOUNT_DEFERRED
 Markiert den Medienzustand als nicht überwindbar, und behält das Medium im Laufwerk bei. Nachfolgende Bereitstellungsanforderungen werden mithilfe von deaktivierten oder demountierbaren Laufwerken erfüllt. Standardmäßig wird die Bereitstellung sofort aufgehoben.
NTMS_DISMOUNT_IMMEDIATE
 Heben Sie die Bereitstellung des Laufwerks sofort auf.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS an den Medienpool oder die Medienbibliothek, die die Medien enthält, 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_DEVICE_NOT_AVAILABLE
 Mindestens eine Ressource, die für die Demontage erforderlich ist, ist derzeit nicht verfügbar (wahrscheinlich deaktiviert).
ERROR_INVALID_LIBRARY
 Die Bibliothek, die die Medien enthält, ist ungültig.
ERROR_INVALID_MEDIA
 Mindestens eines der angegebenen Medien ist ungültig.
ERROR_INVALID_STATE
 Beim Aufheben der Bereitstellung ist ein unerwarteter Medien- oder Gerätezustand aufgetreten.
ERROR_MEDIA_OFFLINE
 Die angegebenen Medien sind offline.
ERROR_MEDIA_NOT_AVAILABLE
 Mindestens eine Medienressourcen, die für die Bereitstellung erforderlich sind, sind derzeit nicht verfügbar (wahrscheinlich deaktiviert).
ERROR_NOT_ENOUGH_MEMORY
 Während der Verarbeitung ist ein Fehler bei der Speicherzuordnung aufgetreten.
ERROR_SUCCESS
 Die Medienaufhebung wurde in eine Warteschlange gestellt.
ERROR_TIMEOUT
 Das Timeoutereignis ist abgelaufen, während die Anwendung versucht hat, eine oder mehrere Ressourcen zu erwerben.

Hinweise

Eine Anwendung muss die DismountNtmsMedia-Funktion verwenden, um die Laufwerkressource freizugeben, nachdem die Anwendung das angegebene Medium verwendet hat. Nicht freigegebene Medien können nicht von anderen RSM-Sitzungen verwendet werden.

Die DismountNtmsMedia-Funktion wird zurückgegeben, sobald der Vorgang mit RSM in die Warteschlange gestellt wird. Die Anwendung kann warten, bis der Seitenzustand im Leerlauf ist.

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

Media Services-Funktionen

MountNtmsMedia