функция обратного вызова PFAX_SEND_CALLBACK (faxdev.h)

Функция FaxSendCallback — это определяемая приложением или библиотекой функция обратного вызова, которую вызывает поставщик служб факсов (FSP) для уведомления факсимильной службы о том, что выполняется исходящий факсимильный вызов.

Тип данных PFAX_SEND_CALLBACK является указателем на функцию FaxSendCallback . FaxSendCallback — это заполнитель для имени определяемой приложением или библиотекой функции.

Синтаксис

PFAX_SEND_CALLBACK PfaxSendCallback;

BOOL PfaxSendCallback(
  [in] HANDLE FaxHandle,
  [in] HCALL CallHandle,
  [in] DWORD Reserved1,
  [in] DWORD Reserved2
)
{...}

Параметры

[in] FaxHandle

Тип: HANDLE

Указывает дескриптор факса, возвращаемый функцией FaxDevStartJob .

[in] CallHandle

Тип: HCALL

Указывает дескриптор вызова, возвращаемый сообщением LINE_CALLSTATE TAPI 2.x.

[in] Reserved1

Тип: DWORD

Этот параметр зарезервирован для дальнейшего использования корпорацией Майкрософт. Для него необходимо задать нулевое значение.

[in] Reserved2

Тип: DWORD

Этот параметр зарезервирован для дальнейшего использования корпорацией Майкрософт. Для него необходимо задать нулевое значение.

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

Тип: BOOL

Служба факсов возвращает значение TRUE , указывающее, что активная операция факса должна продолжаться.

Служба факсов возвращает значение FALSE , указывающее, что активная операция факса должна быть завершена. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функция обратного вызова FaxSendCallback предоставляет службе факсов функцию CallHandle , назначаемую TAPI. Этот дескриптор необходим для маршрутизации сообщений TAPI. Если FSP не вызывает FaxSendCallback, он пропустит все дальнейшие события вызова.

Виртуальному поставщику служб FSP не требуется функция FaxSendCallback .

Требования

   
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header faxdev.h

См. также раздел

Функции поставщика службы факсов

FaxDevSend

FaxDevStartJob

LINE_CALLSTATE

Использование API поставщика службы факсов