IDiscRecorder2::ReleaseExclusiveAccess-Methode (imapi2.h)
Gibt den exklusiven Zugriff auf das Gerät frei.
Syntax
HRESULT ReleaseExclusiveAccess();
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:
| Rückgabecode | Beschreibung |
|---|---|
|
Unspezifizierter Fehler.
Wert: 0x80004005 |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
|
Das Gerät konnte den Befehl nicht innerhalb des Timeoutzeitraums annehmen. Dies kann darauf zurückzuführen sein, dass das Gerät in einen inkonsistenten Zustand versetzt wurde, oder der Timeoutwert für den Befehl muss möglicherweise erhöht werden.
Wert: 0xC0AA020D |
|
Das angegebene Handle ist ungültig.
Wert: 6 |
|
Die angegebene Netzwerkressource oder das angegebene Gerät ist nicht mehr verfügbar.
Wert: 55 |
|
Das gerät, das diesem Recorder während des letzten Vorgangs zugeordnet ist, wurde ausschließlich gesperrt, sodass dieser Vorgang fehlgeschlagen ist.
Wert: 0xC0AA0210 |
Hinweise
Jeder Recorder verfügt über eine Sperranzahl. Der erste Aufruf eines Recorders sperrt das Gerät für den exklusiven Zugriff. Anwendungen können die IDiscRecorder2::AcquireExclusiveAccess-Methode mehrmals verwenden, um mehrere Sperren auf einem Gerät anzuwenden. Bei jedem Aufruf wird die Sperranzahl um eins erhöht.
Beim Entsperren eines Recorders muss die Sperranzahl null erreichen, um das Gerät für andere Clients freizugeben. Durch Aufrufen der ReleaseExclusiveAccess-Methode wird die Sperranzahl um eins verringert.
Es ist eine gleiche Anzahl von Aufrufen der AcquireExclusiveAccess- und ReleaseExclusiveAccess-Methoden erforderlich, um ein Gerät freizugeben. Wenn die Sperranzahl null erreicht, ist das Aufzeichnungsgerät kostenlos. die letzte Sperre wurde entfernt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |