EjectDiskFromSADriveA-Funktion (ntmsapi.h)

Artikel
11/20/2024

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

Die EjectDiskFromSADrive--Funktion gibt die Medien aus, die sich auf einem eigenständigen Wechseldatenträger befinden.

Syntax

DWORD EjectDiskFromSADriveA(
  [in] LPCSTR lpComputerName,
  [in] LPCSTR lpAppName,
  [in] LPCSTR lpDeviceName,
  [in] HWND   hWnd,
  [in] LPCSTR lpTitle,
  [in] LPCSTR lpMessage,
  [in] DWORD  dwOptions
);

Parameter

[in] lpComputerName

Servername des Wechselmedien-Managers (RSM). Wenn dieser Parameter NULL-ist, wird der aktuelle Computername verwendet.

[in] lpAppName

Eindeutige Zeichenfolge, die die Anwendung identifiziert. Dieser Name identifiziert Ressourcen- und Operatoranforderungen. Dieser Parameter ist optional und kann NULL-sein.

[in] lpDeviceName

Name des auszuwerfenden Geräts. Beispiel: \.\Cdrom0 oder \.\PhysicalDriveX (wobei X die Nummer des Laufwerks ist, auf das zugegriffen wird).

[in] hWnd

Behandeln sie ein Dialogfeldfenster für die Benutzerbestätigung.

[in] lpTitle

Titel, der in einem Dialogfeld angezeigt wird, um Benutzereingaben zu erhalten.

[in] lpMessage

Meldung, die in einem Dialogfeld angezeigt wird, um Benutzereingaben zu erhalten.

[in] dwOptions

Auszuführende Aktion. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
NTMS_EJECT_START	Starten Sie den Auswurfvorgang mit einem Port. Das angegebene Medium wird ausgelöst, bis das Timeoutereignis eintritt oder die Funktion mit NTMS_EJECT_STOPerneut aufgerufen wird. Der Timeoutwert wird im Bibliotheksobjekt angegeben und auf alle Ausjektionen in der Bibliothek angewendet.
NTMS_EJECT_STOP	Beenden Sie den Ejection-Prozess, bevor das Timeoutereignis verstrichen ist.
NTMS_EJECT_QUEUE	Zulassen, dass der Auswurf asynchron ist. Die Funktion stellt die angegebenen Medien für den Auswurf in die Warteschlange und gibt dann zurück.
NTMS_EJECT_FORCE	Erzwingen, dass die Medien ausgeworfen werden. Beispielsweise kann NTFS Sperren auf Medien halten, und diese Option bewirkt, dass die Medien trotz dieser Sperre ausgeworfen werden.
NTMS_EJECT_IMMEDIATE	Die Medien sofort und synchron auswerfen. Die Funktion wird erst zurückgegeben, wenn der Auswurf abgeschlossen ist. Die angegebenen Medien werden nicht für den Auswurf in die Warteschlange gestellt.
NTMS_EJECT_ASK_USER	Die Medien sofort und synchron auswerfen. Die Funktion wird erst zurückgegeben, wenn der Auswurf abgeschlossen ist. Die angegebenen Medien werden nicht für den Auswurf in die Warteschlange gestellt. Wenn der Auswurfvorgang fehlschlägt, fordern Sie den Benutzer auf, den Vorgang entweder abzubrechen oder zu erzwingen.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS der Bibliothek wird verweigert. Andere Sicherheitsfehler sind ebenfalls möglich, weisen jedoch auf einen Sicherheitssubsystemfehler hin.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen oder beschädigt werden.
ERROR_DATABASE_FULL	Die Datenbank ist voll.
ERROR_DEVICE_NOT_AVAILABLE	Die Bibliothek ist deaktiviert.
ERROR_INVALID_HANDLE	Die Sitzungs-ID fehlt oder ist ungültig.
ERROR_INVALID_OPERATION	Ein Stopp wurde für eine ungültige Vorgangs-ID ausgeführt.
ERROR_INVALID_PARAMETER	Ein Bibliotheks-ID- oder Vorgangs-ID-Zeiger fehlt.
ERROR_LIBRARY_OFFLINE	Die Bibliotheks-ID bezieht sich auf eine Offlinebibliothek, die keine Medien auswerfen kann.
ERROR_MEDIA_NOT_AVAILABLE	Die Medien sind deaktiviert.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Der Auswurfvorgang war erfolgreich.

Bemerkungen

Obwohl EjectNtmsMedia- in einigen Fällen verwendet werden kann, um die gleiche Funktionalität zu erreichen, bietet EjectDiskFromSADrive- eine bequeme Möglichkeit, Medien von einem eigenständigen Gerät auszuwerfen, indem sie den Laufwerknamen anstelle des RSM-Namens angeben. In einigen Fällen ist es die einzige Möglichkeit, Dateisystemsperren auf den Medien zu überwinden, um diese Medien auszuwerfen.

Die EjectDiskFromSADrive--Funktion wird an die Anwendung zurückgegeben, sobald die Eject-Anforderung in die Warteschlange gestellt wird, es sei denn, NTMS_EJECT_IMMEDIATE Option ist angegeben.

Medien, die mithilfe der EjectDiskFromSADrive-Funktion ausgeworfen werden, werden in die Offlinebibliothek verschoben oder aus der Datenbank gelöscht. Beim Auswerfen werden Medien, nicht erkannte Medien und inkompatible Medien gelöscht.

Die funktion EjectDiskFromSADrive funktioniert nicht mit der Offlinebibliothek.

Anmerkung

Der ntmsapi.h-Header definiert EjectDiskFromSADrive als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ntmsapi.h
Library	Ntmsapi.lib
DLL-	Ntmsapi.dll

Siehe auch

EjectNtmsMedia-

InjectNtmsMedia-

Bibliothekssteuerungsfunktionen

Freigeben über