função TSPI_phoneClose (tspi.h)
A função TSPI_phoneClose fecha o dispositivo de telefone aberto especificado depois de concluir ou anular todas as operações assíncronas pendentes no dispositivo.
Sintaxe
LONG TSPIAPI TSPI_phoneClose(
HDRVPHONE hdPhone
);
Parâmetros
hdPhone
O identificador opaco do provedor de serviços para o telefone a ser fechado. Depois que o telefone for fechado com êxito, esse identificador não será mais válido.
Valor retornado
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Comentários
O provedor de serviços deve relatar a conclusão de cada operação assíncrona. Se esse procedimento for chamado para um telefone no qual há operações assíncronas pendentes, as operações deverão ser relatadas com um resultado apropriado ou código de erro antes que este procedimento retorne. Em geral, a TAPI aguarda que elas sejam concluídas de forma ordenada. No entanto, o provedor de serviços deve estar preparado para lidar com uma chamada antecipada para TSPI_phoneClose em situações de "anulação" ou "desligamento de emergência".
Depois que esse procedimento retornar, o provedor de serviços não deverá relatar mais eventos no telefone. O identificador opaco do provedor de serviços para o telefone torna-se inválido.
O provedor de serviços deve abrir mão de recursos nãoharáveis que reserva enquanto o telefone está aberto. Por exemplo, fechar um telefone acessado por meio de uma porta de comm e modem deve resultar no fechamento da porta de comm, disponibilizando-a para uso por outros aplicativos.
Essa função sempre deve ter êxito, exceto em circunstâncias extraordinárias. A maioria dos chamadores provavelmente ignorará o código de retorno porque eles não poderão compensar nenhum erro que ocorra. Os valores retornados especificados são mais consultivos para fins de diagnóstico de desenvolvimento do que qualquer outra coisa.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |