lineInitialize
9/19/2008
Essa função inicializa uso do aplicativo de TAPI.DLL para uso subseqüente de abstração de linha. Ele registra Mecanismo do aplicativo notificação especificada e retorna o número da linha de dispositivos disponível para o aplicativo. Um dispositivo de linha é qualquer dispositivo que fornece uma implementação para o Linha-Prefixo funções em TAPI.
Syntax
LONG lineInitialize(
LPHLINEAPP lphLineApp,
HINSTANCE hInstance,
LINECALLBACK lpfnCallback,
LPCWSTR lpszAppName,
LPDWORD lpdwNumDevs
);
Parameters
- lphLineApp
[out] Ponteiro para uma localidade que é preenchida com identificador de uso do aplicativo para TAPI.
- hInstance
[no] Identificador de instância do aplicativo cliente ou DLL.
- lpfnCallback
[no] Ponteiro para uma função callback que é chamado para determinar status e Eventos no dispositivo de linha, endereços ou chamadas. Para obter mais informações, consulte lineCallbackFunc.
- lpszAppName
[no] Ponteiro para uma seqüência de caracteres NULL-Terminated que contém somente caracteres Unicode exibível. Se este parâmetro não for NULL, ele contém um nome aplicativo-fornecido para o aplicativo. Esse nome é fornecido na LINECALLINFO estrutura para indicar, em um amigável maneira, qual aplicativo se originou, originalmente aceito ou respondidas a chamar. Este dados podem ser útil para fins log chamar. Se lpszAppName é NULL, arquivo nome do aplicativo é usado em vez disso.
- lpdwNumDevs
[out] Ponteiro para um DWORD-Tamanho localidade. Após bem-sucedido conclusão essa solicitação, esta localidade é preenchido com o número de dispositivos de linha disponível para o aplicativo.
Return Value
Zero indica sucesso. Um número de erro negativa indica que ocorreu um erro. A seguinte tabela mostra os valores de retorno para esta função.
Valor | Descrição |
---|---|
LINEERR_INVALAPPNAME |
Nome do aplicativo inválido |
LINEERR_OPERATIONFAILED |
A operação falhou |
LINEERR_INIFILECORRUPT |
O arquivo INI é corrompido |
LINEERR_RESOURCEUNAVAIL |
O recurso não está disponível |
LINEERR_INVALPOINTER |
Ponteiro inválido |
LINEERR_REINIT |
O aplicativo tentado inicializar TAPI duas vezes. |
LINEERR_NODRIVER |
Nenhum driver foi encontrado |
LINEERR_NODEVICE |
Nenhum dispositivo foi encontrado |
LINEERR_NOMEM |
Nenhuma memória está disponível |
LINEERR_NOMULTIPLEINSTANCE |
Várias instâncias não foram encontradas |
Remarks
O aplicativo pode referir ao individual linha dispositivos usando identificadores dispositivo de linha desse intervalo de zero para dwNumDevs menos um. Um aplicativo não deve presumir que esses dispositivos de linha são capazes de qualquer coisa além o que é especificado pelo subconjunto Basic Telephony sem primeiro consultar suas capacidades dispositivo usando o lineGetDevCaps função.
Aplicativos não devem invocar lineInitialize Sem posteriormente abrindo uma linha (pelo menos para monitoração). Se o aplicativo não estiver monitoração e não usando qualquer dispositivo, ele deve chamar o lineShutdown função de modo que memória recursos alocados pelo TAPI.DLL pode ser lançada se não necessária.
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 |