Função lineGetLineDevStatus (tapi.h)
A função lineGetLineDevStatus permite que um aplicativo consulte o dispositivo de linha aberta especificado para seu status atual.
Sintaxe
LONG lineGetLineDevStatus(
HLINE hLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Parâmetros
hLine
Manipule para o dispositivo de linha aberta a ser consultado.
lpLineDevStatus
Ponteiro para uma estrutura de dados de tamanho variável do tipo LINEDEVSTATUS. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com o dispositivo da linha status. Antes de chamar lineGetLineDevStatus, o aplicativo deve definir o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.
Retornar valor
Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:
LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.
Comentários
Um aplicativo usa lineGetLineDevStatus para consultar o dispositivo de linha para seu status de linha atual. Essas informações status se aplicam globalmente a todos os endereços no dispositivo de linha. Use lineGetAddressStatus para determinar status informações sobre um endereço específico em uma linha.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |
Confira também
Referência básica dos Serviços de Telefonia