Функция FaxDevSend (faxdev.h)

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

Синтаксис

BOOL FaxDevSend(
  [in] HANDLE             FaxHandle,
  [in] PFAX_SEND          FaxSend,
       PFAX_SEND_CALLBACK FaxSendCallback
);

Параметры

[in] FaxHandle

Тип: HANDLE

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

[in] FaxSend

Тип: PFAX_SEND

Указатель на структуру FAX_SEND , содержащую отправляемую информацию. Дополнительные сведения см. в разделе "Примечания".

FaxSendCallback

Тип: PFAX_SEND_CALLBACK

Указатель на функцию обратного вызова, которая уведомляет службу факсов о дескрипторе вызова, назначенном TAPI. Дополнительные сведения см. в разделе "Примечания".

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

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

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

Примечание Для успешной отправки Параметр FaxDevSend() должен возвращать значение TRUE , а Значение FaxDevReportStatus() должно возвращать FS_COMPLETED. Для неудачной отправки Функция FaxDevSend() должна возвращать значение FALSE, а Функция FaxDevReportStatus() должна возвращать любой из следующих кодов: FS_LINE_UNAVAILABLE, FS_NO_ANSWER, FS_NO_DIAL_TONE, FS_DISCONNECTED, FS_BUSY, FS_NOT_FAX_CALL или FS_FATAL_ERROR. Если после сбоя факса факс не должен быть повторно отправлен, Функция FaxDevReportStatus() должна возвращать код, отличный от перечисленных здесь.

 

Комментарии

FSP должен отвечать на функцию FaxDevSend , выполняя вызов, отправляя данные и завершая вызов. Поставщик может вызвать функцию lineSetMediaMode , чтобы правильно задать режим мультимедиа вызова. Поставщик услуг факсов должен набирать номер, указанный членом ReceiverNumberструктуры FAX_SEND .

FSP владеет строкой в контексте функции FaxDevSend и должен обрабатывать все протоколы и исправления ошибок.

Поток данных, хранящийся в файле, указанном элементом FileName структуры FAX_SEND , является файлом класса F (TIFF Class F) с тегами. Дополнительные сведения см. в разделе Формат изображения факса.

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

Требования

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

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

FAX_SEND

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

FaxDevReceive

FaxDevStartJob

FaxSendCallback

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