Metodo IDiscRecorder2::ReleaseExclusiveAccess (imapi2.h)
Rilascia l'accesso esclusivo al dispositivo.
Sintassi
HRESULT ReleaseExclusiveAccess();
Valore restituito
S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:
| Codice restituito | Descrizione |
|---|---|
|
Errore non specificato.
Valore: 0x80004005 |
|
Impossibile allocare la memoria necessaria.
Valore: 0x8007000E |
|
Il dispositivo non è riuscito a accettare il comando entro il periodo di timeout. Questo può essere causato dal dispositivo che ha immesso uno stato incoerente o il valore di timeout per il comando potrebbe essere aumentato.
Valore: 0xC0AA020D |
|
L'handle specificato non è valido.
Valore: 6 |
|
La risorsa di rete o il dispositivo specificati non sono più disponibili.
Valore: 55 |
|
Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'errore di questa operazione.
Valore: 0xC0AA0210 |
Commenti
Ogni registratore ha un conteggio dei blocchi. La prima chiamata a un registratore blocca il dispositivo per l'accesso esclusivo. Le applicazioni possono usare il metodo IDiscRecorder2::AcquireExclusiveAccess più volte per applicare più blocchi in un dispositivo. Ogni chiamata incrementa il conteggio dei blocchi per uno.
Quando si sblocca un registratore, il conteggio dei blocchi deve raggiungere zero per liberare il dispositivo per altri client. Chiamando il metodo ReleaseExclusiveAccess decrementa il conteggio dei blocchi per uno.
Per liberare un dispositivo, è necessario un numero uguale di chiamate ai metodi AcquireExclusiveAccess e ReleaseExclusiveAccess. Quando il conteggio dei blocchi raggiunge zero, il dispositivo di registrazione è libero; l'ultimo blocco è stato rimosso.
Requisiti
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imapi2.h |