Método IDiscRecorder2::ReleaseExclusiveAccess (imapi2.h)
Libera acesso exclusivo ao dispositivo.
Sintaxe
HRESULT ReleaseExclusiveAccess();
Valor retornado
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
| Código de retorno | Descrição |
|---|---|
|
Falha não especificada.
Valor: 0x80004005 |
|
Falha ao alocar a memória necessária.
Valor: 0x8007000E |
|
O dispositivo não aceitou o comando dentro do período de tempo limite. Isso pode ser causado pelo dispositivo ter inserido um estado inconsistente ou o valor de tempo limite para o comando pode precisar ser aumentado.
Valor: 0xC0AA020D |
|
O identificador especificado é inválido.
Valor: 6 |
|
O recurso de rede ou dispositivo especificado não está mais disponível.
Valor: 55 |
|
O dispositivo associado a esse gravador durante a última operação foi bloqueado exclusivamente, fazendo com que essa operação falhasse.
Valor: 0xC0AA0210 |
Comentários
Cada gravador tem uma contagem de bloqueios. A primeira chamada para um gravador bloqueia o dispositivo para acesso exclusivo. Os aplicativos podem usar o método IDiscRecorder2::AcquireExclusiveAccess várias vezes para aplicar vários bloqueios em um dispositivo. Cada chamada incrementa a contagem de bloqueios em um.
Ao desbloquear um gravador, a contagem de bloqueios deve chegar a zero para liberar o dispositivo para outros clientes. Chamar o método ReleaseExclusiveAccess diminui a contagem de bloqueios em um.
Um número igual de chamadas para os métodos AcquireExclusiveAccess e ReleaseExclusiveAccess são necessárias para liberar um dispositivo. Quando a contagem de bloqueios atinge zero, o dispositivo de gravação é gratuito; o último bloqueio foi removido.
Requisitos
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi2.h |