função TSPI_phoneSelectExtVersion (tspi.h)
A função TSPI_phoneSelectExtVersion seleciona a versão de extensão indicada para o dispositivo de telefone indicado. As solicitações subsequentes operam de acordo com essa versão de extensão.
Sintaxe
LONG TSPIAPI TSPI_phoneSelectExtVersion(
HDRVPHONE hdPhone,
DWORD dwExtVersion
);
Parâmetros
hdPhone
O identificador para o telefone para o qual uma versão de extensão deve ser selecionada.
dwExtVersion
A versão da extensão a ser selecionada. Esse número de versão é negociado usando TSPI_phoneNegotiateExtVersion. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária. Chamar essa função com um dwExtVersion de zero cancela a seleção atual.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Comentários
Essa função seleciona a versão de extensão indicada. Embora o número de versão indicado possa ter sido negociado com êxito, uma versão de extensão diferente pode ter sido selecionada nesse ínterim, caso em que essa função falha (retornando PHONEERR_INCOMPATIBLEEXTVERSION).
As operações subsequentes no telefone depois que uma versão de extensão é selecionada se comportam de acordo com essa versão de extensão. Tentativas subsequentes de negociar o relatório de versão de extensão estritamente a versão selecionada ou zero (se o intervalo solicitado não incluir a versão selecionada). Chamar esse procedimento com a extensão especial versão 0 cancela a seleção atual. O dispositivo mais uma vez se torna capaz de dar suporte a sua gama completa de números de versão de extensão.
TSPI_phoneSelectExtVersion normalmente é chamado em duas situações: (1) Um aplicativo solicitado a abrir um telefone, o aplicativo solicitou que uma versão de extensão específica fosse usada e nenhuma versão de extensão foi selecionada no momento; ou (2) o último aplicativo usando uma versão de extensão específica fechou o telefone e a seleção da versão da extensão pode ser cancelada.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |