Função lineGetLineDevStatus (tapi.h)

Artigo
03/05/2024

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.