Método IDiscRecorder::OpenExclusive (imapi.h)
Abre um gravador de disco para acesso exclusivo.
Sintaxe
HRESULT OpenExclusive();
Retornar valor
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:
Comentários
Esse método bloqueia o acesso do sistema de arquivos a um gravador por meio de aplicativos como Explorer. O gravador deve ser aberto com esse método antes que seja possível usar os seguintes métodos: QueryMediaType, Ejetar, Apagar e Fechar.
É importante fechar o gravador antes de chamar IDiscMaster::RecordDisc ou falhará com IMAPI_E_DEVICE_NOTACCESSIBLE. O dispositivo está exclusivamente comprometido para acessar por meio de IDiscRecorder ou IDiscMaster, mas não ambos ao mesmo tempo. Isso é para garantir que não haja confusão em relação às operações permitidas e à propriedade de um gravador durante o controle do aplicativo ou uma gravação.
Um bloqueio exclusivo deve ser mantido pelo menor tempo possível. As solicitações provenientes de outros componentes do sistema operacional não são enfileiradas para execução posterior. Em vez disso, eles simplesmente falham. Isso pode causar confusão com usuários que não acham que uma queimadura está em andamento.
Sempre que OpenExclusive é chamado, parece para o sistema de arquivos que o disco foi removido. Quando a chamada Close correspondente é feita, parece para o sistema de arquivos que a mídia reapareceu. Isso pode causar problemas de execução automática.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [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 | imapi.h |
| Biblioteca | Uuid.lib |
| DLL | Actxprxy.dll |