função TSPI_lineSetAppSpecific (tspi.h)
A função TSPI_lineSetAppSpecific define o campo específico do aplicativo da estrutura LINECALLINFO da chamada especificada.
Sintaxe
LONG TSPIAPI TSPI_lineSetAppSpecific(
HDRVCALL hdCall,
DWORD dwAppSpecific
);
Parâmetros
hdCall
O identificador para a chamada cujo campo específico do aplicativo deve ser definido. O estado de chamada de hdCall pode ser qualquer estado.
dwAppSpecific
O novo conteúdo do membro dwAppSpecific para a estrutura LINECALLINFO da chamada. Esse valor não é interpretado pelo provedor de serviços. Esse parâmetro não é validado pelo TAPI quando essa função é chamada.
Retornar valor
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:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Comentários
O campo específico do aplicativo na estrutura de dados LINECALLINFO que existe para cada chamada não é interpretado pela API de Telefonia ou por qualquer um de seus provedores de serviços. Seu uso é totalmente definido pelos aplicativos. O campo pode ser lido do registro LINECALLINFO retornado por TSPI_lineGetCallInfo. No entanto, TSPI_lineSetAppSpecific deve ser usado para definir o campo para que as alterações se tornem visíveis para outros aplicativos. Quando esse campo é alterado, o provedor de serviços envia uma mensagem LINE_CALLINFO com uma indicação de que o campo AppSpecific foi alterado.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |