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

Recupera o nome do aplicativo cliente que tem acesso exclusivo ao dispositivo.

Sintaxe

HRESULT get_ExclusiveAccessOwner(
  [in] BSTR *value
);

Parâmetros

[in] value

Cadeia de caracteres que contém o nome do aplicativo cliente que tem acesso exclusivo ao dispositivo.

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 geralmente 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
E_POINTER	O ponteiro não é válido. Valor: 0x80004003
E_FAIL	Falha não especificada. Valor: 0x80004005
E_OUTOFMEMORY	Falha ao alocar a memória necessária. Valor: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	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
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	O identificador especificado é inválido. Valor: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	O recurso de rede ou dispositivo especificado não está mais disponível. Valor: 55
E_IMAPI_RECORDER_LOCKED	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

Essa propriedade retorna o atual proprietário de acesso exclusivo do dispositivo. Esse valor vem diretamente de CDROM.SYS e deve ser consultado sempre que uma operação falhar com E_IMAPI_RECORDER_LOCKED de erro.

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

Confira também

IDiscRecorder2