IDiscRecorder::OpenExclusive-Methode (imapi.h)
Öffnet einen DiscRecorder für den exklusiven Zugriff.
Syntax
HRESULT OpenExclusive();
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
Hinweise
Diese Methode blockiert den Dateisystemzugriff auf einen Recorder über Anwendungen wie Explorer. Der Recorder muss mit dieser Methode geöffnet werden, bevor die folgenden Methoden verwendet werden können: QueryMediaType, Eject, Erase und Close.
Es ist wichtig, den Recorder zu schließen, bevor IDiscMaster::RecordDisc aufgerufen wird. Andernfalls schlägt er mit IMAPI_E_DEVICE_NOTACCESSIBLE fehl. Das Gerät wird ausschließlich für den Zugriff über IDiscRecorder oder IDiscMaster committet, aber nicht beide gleichzeitig. Dadurch soll sichergestellt werden, dass es während der Anwendungssteuerung oder eines Brandes keine Verwirrung in Bezug auf zulässige Vorgänge und den Besitz eines Recorders gibt.
Eine exklusive Sperre sollte so kurz wie möglich gehalten werden. Anforderungen, die von anderen Betriebssystemkomponenten stammen, werden zur späteren Ausführung nicht in die Warteschlange eingereiht. Stattdessen sind sie einfach fehlgeschlagen. Dies kann zu Verwirrung mit Benutzern führen, die nicht der Meinung sind, dass eine Verbrennung in Bearbeitung ist.
Jedes Mal, wenn OpenExclusive aufgerufen wird, wird dem Dateisystem angezeigt, dass der Datenträger entfernt wurde. Wenn der entsprechende Close-Aufruf durchgeführt wird, wird dem Dateisystem angezeigt, dass die Medien erneut angezeigt wurden. Dies kann zu Problemen bei der automatischen Ausführung führen.
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 | imapi.h |
| Bibliothek | Uuid.lib |
| DLL | Actxprxy.dll |