Constantes LINEERR_

Veja a seguir uma lista de códigos de erro que o TAPI pode retornar ao invocar operações em linhas, endereços ou chamadas. Para obter mais informações sobre como determinar quais desses códigos de erro uma função específica pode retornar, consulte as descrições de função individuais.

LINEERR_ADDRESSBLOCKED

O endereço especificado é impedido de ser discado na chamada especificada.

LINEERR_ADDRESSBLOCKED

O endereço de chamada de destino tem o bloqueio de chamadas habilitado.

LINEERR_ALLOCATED

A linha não pode ser aberta devido a uma condição persistente, como a de uma porta serial sendo aberta exclusivamente por outro processo.

LINEERR_BADDEVICEID

O identificador de dispositivo ou identificador de dispositivo de linha especificado, como em um parâmetro dwDeviceID , é inválido ou fora do intervalo.

LINEERR_BEARERMODEUNAVAIL

O membro do modo portador em LINECALLPARAMS é inválido, o modo de portador especificado em LINECALLPARAMS não está disponível ou o modo portador de chamada não pode ser alterado para o modo de portador especificado.

LINEERR_BILLINGREJECTED

O modo de cobrança da chamada foi rejeitado.

LINEERR_CALLUNAVAIL

Todas as aparições de chamada no endereço especificado estão atualmente em uso.

LINEERR_COMPLETIONOVERRUN

O número máximo de conclusões de chamadas pendentes foi excedido.

LINEERR_CONFERENCEFULL

O número máximo de partes de uma conferência foi atingido ou o número solicitado de partes não pode ser atendido.

LINEERR_DIALBILLING

O parâmetro de endereço discável contém caracteres de controle de discagem não processados pelo provedor de serviços.

LINEERR_DIALDIALTONE

O parâmetro de endereço discável contém caracteres de controle de discagem não processados pelo provedor de serviços.

LINEERR_DIALPROMPT

O parâmetro de endereço discável contém caracteres de controle de discagem não processados pelo provedor de serviços.

LINEERR_DIALQUIET

O parâmetro de endereço discável contém caracteres de controle de discagem não processados pelo provedor de serviços.

LINEERR_DIALVOICEDETECT

Uso do modificador de discagem (:) não tem suporte. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.0 ou posterior.

LINEERR_DISCONNECTED

A chamada foi desconectada. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.2 ou posterior.

LINEERR_INCOMPATIBLEAPIVERSION

O aplicativo solicitou uma versão tapi ou um intervalo de versão incompatível com ou não pode ser compatível com a implementação da API de Telefonia e o provedor de serviços correspondente.

LINEERR_INCOMPATIBLEEXTVERSION

O aplicativo solicitou um intervalo de versão de extensão inválido ou que não tem suporte do provedor de serviços correspondente.

LINEERR_INIFILECORRUPT

O arquivo Telephon.ini não pode ser lido ou compreendido corretamente pelo TAPI devido a inconsistências internas ou problemas de formatação. Por exemplo, a seção [Locais], [Cartões]ou [Países] do arquivo Telephon.ini pode estar corrompida ou inconsistente.

LINEERR_INUSE

O dispositivo de linha está em uso e não pode ser configurado no momento, permite que uma parte seja adicionada, permita que uma chamada seja atendida, permita que uma chamada seja feita ou permita que uma chamada seja transferida.

LINEERR_INVALADDRESS

Um endereço especificado é inválido ou não é permitido. Se inválido, o endereço contém caracteres ou dígitos inválidos ou o endereço de destino contém caracteres de controle de discagem (W, @, $ou ?) que não têm suporte do provedor de serviços. Se não for permitido, o endereço especificado não será atribuído à linha especificada ou não será válido para redirecionamento de endereço.

LINEERR_INVALADDRESSID

O identificador de endereço especificado é inválido ou fora do intervalo.

LINEERR_INVALADDRESSMODE

O modo de endereço especificado é inválido.

LINEERR_INVALADDRESSSTATE

O estado de endereço especificado contém um ou mais bits que não são constantes LINEADDRESSSTATE_.

LINEERR_INVALADDRESSTYPE

O aplicativo fez referência a um tipo de endereço que não é válido. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 3.0 ou posterior.

LINEERR_INVALAGENTACTIVITY

A atividade de agente especificada não é válida.

LINEERR_INVALAGENTACTIVITY

O aplicativo que invoca essa operação é o destino da entrega indireta. Ou seja, o TAPI determinou que o aplicativo de chamada também é o aplicativo de prioridade mais alta para o tipo de mídia fornecido. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.0 ou posterior.

LINEERR_INVALAGENTGROUP

As informações do grupo de agentes especificadas não são válidas ou contêm erros. A ação solicitada não foi executada.

LINEERR_INVALAGENTGROUP

O aplicativo fez referência a um grupo de agentes que não é válido. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.0 ou posterior.

LINEERR_INVALAGENTID

O identificador de agente especificado é inválido.

LINEERR_INVALAGENTID

Um identificador de agente inválido foi usado. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.0 ou posterior.

LINEERR_INVALAGENTSESSIONSTATE

O estado da sessão do agente é inválido. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.2 ou posterior.

LINEERR_INVALAGENTSTATE

O estado do agente especificado não é válido ou contém erros. Nenhuma alteração foi feita no estado do agente do endereço especificado.

LINEERR_INVALAGENTSTATE

O aplicativo fez referência a um estado de agente que não é válido. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.0 ou posterior.

LINEERR_INVALAPPHANDLE

O identificador do aplicativo (como especificado por um parâmetro hLineApp ) ou o identificador de registro do aplicativo é inválido.

LINEERR_INVALAPPNAME

O nome do aplicativo especificado é inválido. Se um nome de aplicativo for especificado pelo aplicativo, supõe-se que a cadeia de caracteres não contenha caracteres não exibiveis e seja terminada por zero.

LINEERR_INVALBEARERMODE

O modo de portador especificado é inválido.

LINEERR_INVALCALLCOMPLMODE

A conclusão especificada é inválida.

LINEERR_INVALCALLHANDLE

O identificador de chamada especificado não é válido. Por exemplo, o identificador não é NULL , mas não pertence à linha fornecida. Em alguns casos, o identificador de dispositivo de chamada especificado é inválido.

LINEERR_INVALCALLPARAMS

Os parâmetros de chamada especificados são inválidos.

LINEERR_INVALCALLPRIVILEGE

O parâmetro de privilégio de chamada especificado é inválido.

LINEERR_INVALCALLSELECT

O parâmetro select especificado é inválido.

LINEERR_INVALCALLSTATE

O estado atual de uma chamada não está em um estado válido para a operação solicitada.

LINEERR_INVALCALLSTATELIST

A lista de estado de chamada especificada é inválida.

LINEERR_INVALCARD

O identificador de cartão permanente especificado em dwCard não pôde ser encontrado em nenhuma entrada na seção [Cartões] no registro.

LINEERR_INVALCOMPLETIONID

O identificador de conclusão é inválido.

LINEERR_INVALCONFCALLHANDLE

O identificador de chamada especificado para a chamada em conferência é inválido ou não é um identificador para uma chamada em conferência.

LINEERR_INVALCONSULTCALLHANDLE

O identificador de chamada de consulta especificado é inválido.

LINEERR_INVALCOUNTRYCODE

O código de país ou região especificado é inválido.

LINEERR_INVALDEVICECLASS

O dispositivo de linha não tem nenhum dispositivo associado para a classe de dispositivo especificada ou a linha especificada não dá suporte à classe de dispositivo indicada.

LINEERR_INVALDEVICEHANDLE

O identificador de dispositivo de linha é inválido.

LINEERR_INVALDIALPARAMS

Os parâmetros de discagem são inválidos.

LINEERR_INVALDIGITLIST

A lista de dígitos especificada é inválida.

LINEERR_INVALDIGITMODE

O modo de dígito especificado é inválido.

LINEERR_INVALDIGITS

Os dígitos de terminação especificados não são válidos.

LINEERR_INVALEXTVERSION

O número de versão da extensão do provedor de serviços é inválido.

LINEERR_INVALFEATURE

O parâmetro dwFeature é inválido.

LINEERR_INVALFEATURE

O aplicativo invocou um recurso que não está disponível nessa linha.

LINEERR_INVALGROUPID

O identificador de grupo especificado é inválido.

LINEERR_INVALLINEHANDLE

A chamada, o dispositivo, o dispositivo ou o identificador de linha especificados é inválido.

LINEERR_INVALLINESTATE

A configuração do dispositivo pode não ser alterada no estado de linha atual. A linha pode estar em uso por outro aplicativo ou um parâmetro dwLineStates contém um ou mais bits que não são constantes LINEDEVSTATE_. O valor LINEERR_INVALLINESTATE também pode indicar que o dispositivo está desconectado ou fora de serviço. Esses estados são indicados definindo os bits correspondentes aos valores LINEDEVSTATUSFLAGS_CONNECTED e LINEDEVSTATUSFLAGS_INSERVICE como 0 no membro dwDevStatusFlags da estrutura LINEDEVSTATUS retornada pela função lineGetLineDevStatus .

LINEERR_INVALLOCATION

O identificador de local permanente especificado em dwLocation não pôde ser encontrado em nenhuma entrada na seção [Locais] no registro.

LINEERR_INVALMEDIALIST

A lista de mídias especificada é inválida.

LINEERR_INVALMEDIAMODE

A lista de tipos de mídia (modos) a serem monitorados contém informações inválidas, o parâmetro de tipo de mídia especificado é inválido ou o provedor de serviços não dá suporte ao tipo de mídia especificado. Os tipos de mídia com suporte na linha são listados no membro dwMediaModes na estrutura LINEDEVCAPS .

LINEERR_INVALMESSAGEID

O número fornecido em dwMessageID está fora do intervalo especificado pelo membro dwNumCompletionMessages na estrutura LINEADDRESSCAPS .

LINEERR_INVALPARAM

Um parâmetro ou estrutura para o qual um parâmetro aponta contém informações inválidas, um código de país ou região é inválido, um identificador de janela é inválido ou o parâmetro de lista de encaminhamento especificado contém informações inválidas.

LINEERR_INVALPARKID

O identificador do parque é inválido.

LINEERR_INVALPARKMODE

O modo de parque especificado é inválido.

LINEERR_INVALPASSWORD

A senha especificada não está correta e a ação solicitada não foi executada.

LINEERR_INVALPASSWORD

O aplicativo usou uma senha inválida. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI 2.0 ou posterior.

LINEERR_INVALPOINTER

Um ou mais dos parâmetros de ponteiro especificados (como lpCallList, lpdwAPIVersion, lpExtensionID, lpdwExtVersion, lphIcon, lpLineDevCaps e lpToneList) são inválidos ou um ponteiro necessário para um parâmetro de saída é NULL.

LINEERR_INVALPRIVSELECT

Um sinalizador inválido ou uma combinação de sinalizadores foi definido para o parâmetro dwPrivileges .

LINEERR_INVALRATE

A taxa especificada é inválida.

LINEERR_INVALREQUESTMODE

O indicador LINEREQUESTMODE é inválido.

LINEERR_INVALTERMINALID

O identificador de terminal especificado é inválido.

LINEERR_INVALTERMINALMODE

O parâmetro de modos de terminal especificado é inválido.

LINEERR_INVALTIMEOUT

Não há suporte para tempos limite ou um valor está fora do intervalo válido especificado em LINEDEVCAPS.

LINEERR_INVALTONE

O tom personalizado especificado não representa um tom válido ou é composto por muitas frequências ou a estrutura de tom especificada não descreve um tom válido.

LINEERR_INVALTONELIST

A lista de tons especificada é inválida.

LINEERR_INVALTONEMODE

O parâmetro de modo de tom especificado é inválido.

LINEERR_INVALTRANSFERMODE

O parâmetro de modo de transferência especificado é inválido.

LINEERR_LINEMAPPERFAILED

LINEMAPPER foi o valor passado no parâmetro dwDeviceID , mas nenhuma linha foi encontrada que corresponda aos requisitos especificados no parâmetro lpCallParams .

LINEERR_NOCONFERENCE

A chamada especificada não é um identificador de chamada em conferência ou uma chamada de participante.

LINEERR_NODEVICE

O identificador de dispositivo especificado, que anteriormente era válido, não é mais aceito porque o dispositivo associado foi removido do sistema desde que o TAPI foi inicializado pela última vez. Como alternativa, o dispositivo de linha não tem nenhum dispositivo associado para a classe de dispositivo fornecida.

LINEERR_NODRIVER

Não foi possível localizar Tapiaddr.dll ou o provedor de serviços telefônicos do dispositivo especificado descobriu que um de seus componentes está ausente ou corrompido de uma forma que não foi detectada no momento da inicialização. O usuário deve ser aconselhado a usar a Painel de Controle de Telefonia para corrigir o problema.

LINEERR_NOMEM

Memória insuficiente para executar a operação ou não é possível bloquear a memória.

LINEERR_NOMULTIPLEINSTANCE

Um provedor de serviços de telefonia que não dá suporte a várias instâncias está listado mais de uma vez na seção [Provedores] no registro. O aplicativo deve aconselhar o usuário a usar o Painel de Controle de Telefonia para remover o driver duplicado.

LINEERR_NOMULTIPLEINSTANCE

Várias instâncias desse provedor de serviços não são permitidas.

LINEERR_NOREQUEST

Atualmente, não há nenhuma solicitação pendente do modo indicado ou o aplicativo não é mais o aplicativo de prioridade mais alta para o modo de solicitação especificado.

LINEERR_NOTOWNER

O aplicativo não tem privilégio de proprietário para a chamada especificada.

LINEERR_NOTREGISTERED

O aplicativo não está registrado como um destinatário de solicitação para o modo de solicitação indicado.

LINEERR_OPERATIONFAILED

A operação falhou por um motivo não especificado ou desconhecido.

LINEERR_OPERATIONUNAVAIL

A operação não está disponível, como para o dispositivo especificado ou a linha especificada.

LINEERR_RATEUNAVAIL

Atualmente, o provedor de serviços não tem largura de banda suficiente disponível para a taxa especificada.

LINEERR_REINIT

Se a reinicialização tapi tiver sido solicitada, por exemplo, como resultado da adição ou remoção de um provedor de serviços de telefonia, as solicitações lineInitialize, lineInitializeEx ou lineOpen serão rejeitadas com esse erro até que o último aplicativo desligue o uso da API (usando lineShutdown), momento em que a nova configuração se torna eficaz e os aplicativos são novamente autorizados a chamar lineInitialize ou lineInitializeEx.

LINEERR_REINIT

O aplicativo tentou inicializar o TAPI duas vezes.

LINEERR_REQUESTOVERRUN

Mais solicitações estão pendentes do que o dispositivo pode lidar.

LINEERR_RESOURCEUNAVAIL

Recursos insuficientes para concluir a operação. Por exemplo, uma linha não pode ser aberta devido a um comprometimento excessivo de recursos dinâmicos.

LINEERR_STRUCTURETOOSMALL

O membro dwTotalSize de uma estrutura não especifica memória suficiente para conter a parte fixa da estrutura especificada.

LINEERR_TARGETNOTFOUND

Um destino para a entrega da chamada não foi encontrado. Isso poderá ocorrer se o aplicativo nomeado não tiver aberto a mesma linha com o bit LINECALLPRIVILEGE_OWNER no parâmetro dwPrivileges de lineOpen. Ou, no caso da entrega do modo de mídia, nenhum aplicativo abriu a mesma linha com o bit LINECALLPRIVILEGE_OWNER no parâmetro dwPrivileges de lineOpen e com o tipo de mídia especificado no parâmetro dwMediaMode que foi especificado no parâmetro dwMediaModes de lineOpen.

LINEERR_TARGETSELF

O aplicativo que invoca essa operação é o destino da entrega indireta. Ou seja, o TAPI determinou que o aplicativo de chamada também é o aplicativo de prioridade mais alta para o tipo de mídia fornecido.

LINEERR_UNINITIALIZED

A operação foi invocada antes de qualquer aplicativo chamado lineInitialize ou lineInitializeEx.

LINEERR_USERCANCELLED

O usuário cancelou a chamada. Esse valor é exposto somente a aplicativos que negociam uma versão TAPI da 2.2 ou posterior.

LINEERR_USERUSERINFOTOOBIG

A cadeia de caracteres que contém informações de usuário-usuário excede o número máximo de bytes especificados no dwUUIAcceptSize, dwUUIAnswerSize, dwUUIDropSize, dwUUIMakeCallSize ou dwUUISendUserUserInfoSize membro de LINEDEVCAPS ou a cadeia de caracteres que contém informações do usuário é muito longa.

Comentários

Os valores 0xC0000000 por meio de 0xFFFFFFFF estão disponíveis para extensões específicas do dispositivo. Os valores 0x80000000 por meio de 0xBFFFFFFF são reservados, enquanto 0x00000000 por meio de 0x7FFFFFFF são usados como identificadores de solicitação.

Se um aplicativo receber um retorno de erro que não manipula especificamente (como um erro definido por uma extensão específica do dispositivo), ele deverá tratar o erro como um LINEERR_OPERATIONFAILED (por um motivo não especificado).

Ao invocar o LINEERR_constants que são novos com TAPI 3.0, o arquivo Tapierr.mc deve ser atualizado com novas mensagens.

Requisitos

Requisito	Valor
Versão do TAPI	Requer TAPI 2.0 ou posterior
Cabeçalho	Tapi.h

Confira também

LINEADDRESSCAPS

LINEDEVCAPS

LINEDEVSTATUS

lineGetLineDevStatus

Lineinitialize

Lineinitializeex

Lineopen

Lineshutdown