Compartilhar via


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

LINEDEVSTATUS

Visão geral da referência do TAPI 2.2

Linegetaddressstatus