Функция lineGetAgentStatusA (tapi.h)

Статья
11/20/2024

Функция lineGetAgentStatus получает состояние, связанное с агентом, по указанному адресу.

Синтаксис

LONG lineGetAgentStatusA(
  HLINE             hLine,
  DWORD             dwAddressID,
  LPLINEAGENTSTATUS lpAgentStatus
);

Параметры

hLine

Обработайте устройство открытой строки.

dwAddressID

Адрес на устройстве открытой строки, состояние агента которого требуется запросить. Идентификатор адреса постоянно связан с адресом; Идентификатор остается постоянным в обновлениях операционной системы.

lpAgentStatus

Указатель на изменяемую структуру типа LINEAGENTSTATUS. После успешного завершения запроса эта структура заполняется сведениями о состоянии агента. Перед вызовом lineGetAgentStatusприложение должно задать dwTotalSize элемент этой структуры, чтобы указать объем памяти, доступной TAPI для возврата сведений.

Примечание Если параметры размера в структуре неверны, существует вероятность перезаписи памяти. Дополнительные сведения о настройке размеров структуры см. в разделе выделение памяти.

Возвращаемое значение

Возвращает положительный идентификатор запроса, если начинается асинхронная операция; в противном случае одно из этих отрицательных значений ошибок:

LINEERR_INVALADDRESSID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Замечания

Заметка

Заголовок tapi.h определяет lineGetAgentStatus как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

LINEAGENTSTATUS

дополнительных функций службы

Обзор TAPI 2.2

Поделиться через