lineNegotiateAPIVersion
.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
Essa função permite que um aplicativo para negociar uma versão TAPI usar.
Syntax
LONG lineNegotiateAPIVersion(
HLINEAPP hLineApp,
DWORD dwDeviceID,
DWORD dwAPILowVersion,
DWORD dwAPIHighVersion,
LPDWORD lpdwAPIVersion,
LPLINEEXTENSIONID lpExtensionID
);
Parameters
- hLineApp
[no] Identificador para registro do aplicativo com TAPI.
- dwDeviceID
[no] Identificador do dispositivo de linha a ser consultado.
- dwAPILowVersion
[no] Menos recente versão TAPI o aplicativo é compatível com. O alto-palavra ordem é o número versão principal; a baixa-palavra ordem é o número versão secundária.
- dwAPIHighVersion
[no] Versão Mais Recente TAPI o aplicativo é compatível com. O alto-palavra ordem é o número versão principal; a baixa-palavra ordem é o número versão secundária.
- lpdwAPIVersion
[out] Ponteiro para um DWORD-Tamanho localidade que contém o número versão TAPI que foi negociado. Se a negociação tiver êxito, esse número está no intervalo entre dwAPILowVersion e dwAPIHighVersion.
- lpExtensionID
[out] Ponteiro para uma estrutura de tipo LINEEXTENSIONID. Se o provedor serviço para especificado dwDeviceID parâmetro suporta extensões específicas do provedor, em seguida, após um bem-sucedido negociação, essa estrutura é preenchida com o identificador extensão dessas Extensões. Essa estrutura contém zeros se a linha fornece não extensões. Um aplicativo pode ignorar o parâmetro retornado se ele não usa as extensões.
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_BADDEVICEID |
Identificador de dispositivo fornecido está incorreto. |
LINEERR_NODRIVER |
Nenhum driver foi encontrado. |
LINEERR_INCOMPATIBLEAPIVERSION |
A versão API é incompatível. |
LINEERR_OPERATIONFAILED |
A operação falhou. |
LINEERR_INVALAPPHANDLE |
O identificador era inválido. |
LINEERR_RESOURCEUNAVAIL |
O recurso não está disponível. |
LINEERR_INVALPOINTER |
O ponteiro é inválido. |
LINEERR_UNINITIALIZED |
O parâmetro é não inicializado. |
LINEERR_NOMEM |
Nenhuma memória está disponível. |
LINEERR_OPERATIONUNAVAIL |
A operação é não disponível. |
LINEERR_NODEVICE |
Nenhuma devide foi encontrado. |
Remarks
Use o lineInitialize função para determinar o número de dispositivos de linha presentes no sistema. Identificador de dispositivo especificado por dwDeviceID Varia de zero para uma menor do que o número de dispositivos de linha presentes.
O lineNegotiateAPIVersion função é usada para negociar a número de versão TAPI usar. Ele também recupera o identificador extensão com suporte pelo dispositivo de linha e retorna zeros se nenhum extensões forem com suporte. Se o aplicativo deseja usar as extensões definido pelo identificador de extensão retornado, ele deverá chamar o lineNegotiateExtVersion função para negociar a versão extensão usar.
O número versão TAPI negociado é que em qual TAPI pode operar. Se intervalos versão fazer não sobreposição, o aplicativo e API ou serviço provedor versões são incompatível e um erro será retornado.
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 |