Compartir a través de

Método IDiscRecorder2::ReleaseExclusiveAccess (imapi2.h)

  • Artículo

Libera el acceso exclusivo al dispositivo.

Sintaxis

HRESULT ReleaseExclusiveAccess();

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
E_FAIL
 Error no especificado.

Valor: 0x80004005
E_OUTOFMEMORY
 No se pudo asignar la memoria necesaria.

Valor: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT
 El dispositivo no pudo aceptar el comando dentro del período de tiempo de espera. Esto puede deberse a que el dispositivo ha entrado en un estado incoherente o puede que sea necesario aumentar el valor de tiempo de espera del comando.

Valor: 0xC0AA020D
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
 El identificador especificado no es válido.

Valor: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
 El recurso de red o el dispositivo especificados ya no se encuentran disponibles.

Valor: 55
E_IMAPI_RECORDER_LOCKED
 El dispositivo asociado a esta grabadora durante la última operación se ha bloqueado exclusivamente, lo que provoca un error en esta operación.

Valor: 0xC0AA0210

Comentarios

Cada grabadora tiene un recuento de bloqueos. La primera llamada a una grabadora bloquea el dispositivo para el acceso exclusivo. Las aplicaciones pueden usar el método IDiscRecorder2::AcquireExclusiveAccess varias veces para aplicar varios bloqueos en un dispositivo. Cada llamada incrementa el recuento de bloqueos en uno.

Al desbloquear una grabadora, el recuento de bloqueos debe alcanzar cero para liberar el dispositivo para otros clientes. La llamada al método ReleaseExclusiveAccess disminuye el recuento de bloqueos en uno.

Se necesita un número igual de llamadas a los métodos AcquireExclusiveAccess y ReleaseExclusiveAccess para liberar un dispositivo. Cuando el número de bloqueos alcanza cero, el dispositivo de grabación es libre; se ha quitado el último bloqueo.

Requisitos

   
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2.h

Consulte también

IDiscRecorder2

IDiscRecorder2::AcquireExclusiveAccess

IDiscRecorder2::get_ExclusiveAccessOwner