lineNegotiateExtVersion
.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 extensão a ser usado com o dispositivo de linha especificado. Esta operação não precisa ser chamado se o aplicativo não suporte Extensões.
Syntax
LONG WINAPI lineNegotiateExtVersion(
HLINEAPP hLineApp,
DWORD dwDeviceID,
DWORD dwAPIVersion,
DWORD dwExtLowVersion,
DWORD dwExtHighVersion,
LPDWORD lpdwExtVersion
);
Parameters
- hLineApp
Identificador para registro do aplicativo com TAPI.
- dwDeviceID
Dispositivo de linha a ser consultado.
- dwAPIVersion
Número versão TAPI que foi negociado para o dispositivo de linha especificado usando lineNegotiateAPIVersion.
- dwExtLowVersion
Extensão menos recente versão do identificador de extensão retornado pelo lineNegotiateAPIVersion função que 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.
- dwExtHighVersion
Versão Mais Recente extensão do identificador de extensão retornado pela lineNegotiateAPIVersion Se 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.
- lpdwExtVersion
Ponteiro para um DWORD que contém o número versão extensão que foi negociado. Se a negociação tiver êxito, esse número está no intervalo entre dwExtLowVersion e dwExtHighVersion.
Return Value
Retorna zero se a solicitação for bem-sucedido 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_BADDEVICEID |
O identificador dispositivo está incorreto. |
LINEERR_NOMEM |
Não há memória o suficiente disponível. |
LINEERR_INCOMPATIBLEAPIVERSION |
A versão API é incompatível. |
LINEERR_NODRIVER |
O driver não foi encontrado. |
LINEERR_INCOMPATIBLEEXTVERSION |
A versão extensão é incompatível. |
LINEERR_OPERATIONFAILED |
A operação falhou. |
LINEERR_INVALAPPHANDLE |
O identificador para o registro aplicativos com TAPI é inválido. |
LINEERR_RESOURCEUNAVAIL |
Os recursos são não disponível. |
LINEERR_INVALPOINTER |
O ponteiro é inválido. |
LINEERR_UNINITIALIZED |
Um parâmetro é não inicializado. |
LINEERR_NODEVICE |
O dispositivo não foi encontrado. |
LINEERR_OPERATIONUNAVAIL |
A operação é não disponível. |
Remarks
Use o lineInitializeEx 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 negocia o número de versão API usar. Ele também recupera o identificador extensão com suporte pelo dispositivo de linha, que é zeros se nenhum extensões são fornecidas. Números de versão devem ser incrementados por um para cada versão. Deixando intervalos na versão de lançamento numeração pode causar resultados inesperados.
Se o aplicativo deseja usar as extensões definido pelo identificador de extensão retornado, ele deverá chamar lineNegotiateExtVersion Para negociar a versão extensão usar.
O número versão extensão negociado é que sob a qual o aplicativo e serviço provedor devem ambos operar. Se intervalos versão fazer não sobreposição, o aplicativo e serviço provedor versões são incompatível e um erro será retornado.
Observação
Essa função é TAPI versão 2.0 e posterior.
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 |