DismountNtmsMedia-Funktion (ntmsapi.h)

Artikel
02/29/2024

[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

Freigeben über