IDiscRecorder2::get_ExclusiveAccessOwner-Methode (imapi2.h)

Artikel
08/24/2023

Ruft den Namen der Clientanwendung ab, die exklusiven Zugriff auf das Gerät hat.

Syntax

HRESULT get_ExclusiveAccessOwner(
  [in] BSTR *value
);

Parameter

[in] value

Zeichenfolge, die den Namen der Clientanwendung enthält, die exklusiven Zugriff auf das Gerät hat.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode	Beschreibung
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
E_FAIL	Unspezifizierter Fehler. Wert: 0x80004005
E_OUTOFMEMORY	Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	Das Gerät konnte den Befehl innerhalb des Timeoutzeitraums nicht annehmen. Dies kann dadurch verursacht werden, dass das Gerät einen inkonsistenten Zustand eingegeben hat, oder der Timeoutwert für den Befehl muss möglicherweise erhöht werden. Wert: 0xC0AA020D
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	Das angegebene Handle ist ungültig. Wert: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	Die angegebene Netzwerkressource oder das angegebene Gerät ist nicht mehr verfügbar. Wert: 55
E_IMAPI_RECORDER_LOCKED	Das Gerät, das diesem Rekorder während des letzten Vorgangs zugeordnet ist, wurde ausschließlich gesperrt, sodass dieser Vorgang fehlschlägt. Wert: 0xC0AA0210

Hinweise

Diese Eigenschaft gibt den aktuellen exklusiven Zugriffsbesitzer des Geräts zurück. Dieser Wert stammt direkt von CDROM.SYS und sollte immer abgefragt werden, wenn ein Vorgang mit Fehler E_IMAPI_RECORDER_LOCKED.

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

Weitere Informationen

IDiscRecorder2

Freigeben über