lineMakeCall
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/19/2008
Esta função coloca um chamar na linha especificada para o endereço destino especificado. Opcionalmente, chamar parâmetros podem ser especificados se anything but usar como padrão chamar instalação parâmetros são solicitados.
Syntax
LONG lineMakeCall(
HLINE hLine,
LPHCALL lphCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode,
LPLINECALLPARAMS const lpCallParams
);
Parameters
- hLine
[no] Identificador para o aberto dispositivo de linha na qual um chamar está para ser se originou.
- lphCall
[no] Ponteiro para um identificador HCALL. O identificador é válido somente após o LINE_REPLY mensagem é recebida pelo aplicativo indicando que o lineMakeCall função concluída com êxito. Use este identificador para identificar a chamar quando chamar outras operações telefonia na chamar. O aplicativo inicialmente é o único proprietário deste chamar. Esse identificador é void se a função retornará um erro (sincronicamente ou de forma assíncrona pela mensagem de resposta).
- lpszDestAddress
[no] Ponteiro para o seqüência de caracteres NULL-Terminated que contém o endereço destino. Isso segue o padrão discável formato número. Esse ponteiro pode ser NULL para endereços não-discados (como com um telefone de acesso). Provedores de serviço que têm recursos Multiplexing inversas podem habilitar um aplicativo para especificar múltiplo endereços at once.
- dwCountryCode
[no] Especifica a codificar Country/Region do chamado parte. Se um valor de 0 for especificado, um usar como padrão é usado pela implementação.
- lpCallParams
[no] Ponteiro para um LINECALLPARAMS estrutura. Essa estrutura permite que o aplicativo para especificar como ele quer a chamar para ser configurar. Se NULL for especificada, chamar uma voz 3.1-kHz usar como padrão é estabelecida e um endereço de origem arbitrário na linha está selecionado. Essa estrutura permite que o aplicativo para selecionar elementos such as modo de transmissão a chamar, taxa dados, modo mídia esperado, endereço de origem, bloqueio de dados de identificação chamador e discagem parâmetros.
Return Value
Um identificador solicitação positivo indica que a função foi concluída de forma assíncrona. Um número de erro negativa indica que um erro. O dwParam2 parâmetro do correspondente mensagem LINE_REPLY será zero se a função tiver êxito, ou é um número negativo erro se ocorrer um erro. A seguinte tabela mostra os valores de retorno para esta função.
| Valor | Descrição |
|---|---|
LINEERR_ADDRESSBLOCKED |
O endereço está bloqueado |
LINEERR_BEARERMODEUNAVAIL |
O membro modo de transmissão em LINECALLPARAMS é inválido, o modo de transmissão especificada na LINECALLPARAMS Não está disponível ou a chamar modo de transmissão não pode ser alterado para o modo de transmissão especificada. |
LINEERR_CALLUNAVAIL |
É a chamar não disponível. |
LINEERR_DIALBILLING |
O parâmetro endereço discável controle discagem contém caracteres que não são processadas pelo provedor de serviço. |
LINEERR_DIALDIALTONE |
O parâmetro endereço discável controle discagem contém caracteres que não são processadas pelo provedor de serviço. |
LINEERR_DIALPROMPT |
O parâmetro endereço discável controle discagem contém caracteres que não são processadas pelo provedor de serviço. |
LINEERR_DIALQUIET |
O parâmetro endereço discável controle discagem contém caracteres que não são processadas pelo provedor de serviço. |
LINEERR_INUSE |
A linha está em uso. |
LINEERR_INVALADDRESS |
O endereço é inválido. |
LINEERR_INVALADDRESSID |
O ID endereço é inválido. |
LINEERR_INVALADDRESSMODE |
O modo endereço é inválido. |
LINEERR_INVALBEARERMODE |
O modo de transmissão é inválido. |
LINEERR_INVALCALLPARAMS |
Parâmetros inválidos usados para este chamar. |
LINEERR_INVALCOUNTRYCODE |
Codificar o Country/Region fornecido era inválido. |
LINEERR_INVALLINEHANDLE |
O identificador de linha é inválido. |
LINEERR_INVALLINESTATE |
A linha não está em um estado, que esta operação pode ser executada. |
LINEERR_INVALMEDIAMODE |
O modo de mídia é inválido. |
LINEERR_INVALPARAM |
Os parâmetros são inválido. |
LINEERR_INVALPOINTER |
O ponteiro é inválido. |
LINEERR_INVALRATE |
A taxa é inválido. |
LINEERR_NOMEM |
A operação requer mais memória que está atualmente disponível. |
LINEERR_OPERATIONFAILED |
A operação falhou. |
LINEERR_OPERATIONUNAVAIL |
A operação é não disponível. Com divisão codificar múltiplo acessar (CDMA), essa função irá falhar se um chamar está em andamento. CDMA não fornece a funcionalidade necessária para suporte a seguinte funções TAPI:
Alguns portadoras celular fornecem equivalente funcionalidade através de memória flash recurso, que com TAPI 2.2 pode ser acessado com a função lineGenerateDigits. Porque o memória flash exata seqüências controladas por provedores de celular, o aplicativo deve estar completamente ciente dos códigos necessários implementados por provedores de celular. |
LINEERR_RATEUNAVAIL |
A taxa é não disponível. |
LINEERR_RESOURCEUNAVAIL |
O recurso não está disponível. |
LINEERR_STRUCTURETOOSMALL |
A estrutura é muito pequena. |
LINEERR_UNINITIALIZED |
O parâmetro é não inicializado. |
LINEERR_USERUSERINFOTOOBIG |
Informações de usuários é muito grandes. |
Remarks
Se LINEERR_INVALLINESTATE for retornado, a linha não está em um estado em que esta operação pode ser executada. Uma lista de atualmente válido operações podem ser encontradas na dwLineFeatures membro (do tipo LINEFEATURE_) in a LINEDEVSTATUS estrutura. Se LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE ou LINEERR_DIALPROMPT for retornado, nenhuma das ações executados pelo caso contrário lineMakeCall Ocorreram; de exemplo, nenhum do endereço discável prior to o caractere incorreto tiver sido discado, nenhum estado alternar gancho foi alterado e assim por diante.
Após discagem for concluída, vários LINE_CALLSTATE As mensagens normalmente são enviadas para o aplicativo para notificá-lo sobre o progresso do chamar. Não geralmente válido seqüência de chamar-estado transições for especificado, como não único corrigido seqüência de transições pode ser garantido na sessão prática. Uma seqüência típica pode causar um chamar a transição do Sinal de Linha, discagem, Prosseguir, ringback, para Conectado. Com linhas não-discadas, a chamar pode geralmente transição diretamente para Conectado estado.
Um aplicativo tem a opção para especificar um endereço de origem no dispositivo de linha especificado. Um provedor serviço que todos os modelos stations em um alternar como endereços em um dispositivo de linha simples permite que o aplicativo para se originam chamadas de qualquer um dessas estações usando lineMakeCall.
Habilitar parâmetros de chamar o aplicativo para tornar chamadas non-Voice ou chamar especial solicitação instalação opções que não estão disponível Por padrão.
Um aplicativo pode parcialmente discagem usando lineMakeCall e continuar a usar discagem de lineDial função. Para abandonar uma tentativa chamar, use o lineDrop função.
Após lineMakeCall Retorna um mensagem de resposta com êxito para o aplicativo, uma mensagem LINE_CALLSTATE é enviada para o aplicativo para indicar o atual estado do chamar. Este estado não é necessariamente LINECALLSTATE_DIALTONE.
Requirements
| Header | tapi.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
lineDeallocateCall
lineDial
lineDrop
LINE_CALLSTATE (TAPI)
LINE_REPLY
LINECALLPARAMS
LINEDEVSTATUS