Fungsi FaxDevSend (faxdev.h)

Layanan faks memanggil fungsi FaxDevSend untuk memberi sinyal penyedia layanan faks (FSP) bahwa ia harus memulai transmisi faks keluar. Setiap FSP harus mengekspor fungsi FaxDevSend .

Sintaks

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

Parameter

[in] FaxHandle

Jenis: HANDEL

Menentukan handel faks yang dikembalikan oleh fungsi FaxDevStartJob .

[in] FaxSend

Jenis: PFAX_SEND

Penunjuk ke struktur FAX_SEND yang berisi informasi pengiriman. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

FaxSendCallback

Jenis: PFAX_SEND_CALLBACK

Penunjuk ke fungsi panggilan balik yang memberi tahu layanan faks dari handel panggilan yang ditetapkan TAPI. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, layanan faks memanggil GetLastError.

Catatan Untuk pengiriman yang berhasil, FaxDevSend() harus mengembalikan TRUE dan FaxDevReportStatus() harus mengembalikan FS_COMPLETED. Untuk pengiriman yang gagal, FaxDevSend() harus mengembalikan FALSE, dan FaxDevReportStatus() harus mengembalikan salah satu kode berikut: FS_LINE_UNAVAILABLE, FS_NO_ANSWER, FS_NO_DIAL_TONE, FS_DISCONNECTED, FS_BUSY, FS_NOT_FAX_CALL, atau FS_FATAL_ERROR. Jika setelah faks yang gagal, faks tidak boleh dikirim ulang, FaxDevReportStatus() harus mengembalikan kode apa pun selain yang tercantum di sini.

 

Keterangan

FSP harus menanggapi fungsi FaxDevSend dengan melakukan panggilan, mengirim data, dan mengakhiri panggilan. Penyedia dapat memanggil fungsi lineSetMediaMode untuk mengatur mode media panggilan dengan benar. Penyedia layanan faks harus melakukan panggilan nomor yang ditentukan oleh anggota ReceiverNumber dari struktur FAX_SEND .

FSP memiliki kepemilikan garis sementara dalam konteks fungsi FaxDevSend , dan harus menangani semua protokol dan koreksi kesalahan.

Aliran data yang disimpan dalam file yang ditentukan oleh anggota FileName dari struktur FAX_SEND adalah file Kelas Format File Gambar Bertag (Kelas F TIFF). Untuk informasi selengkapnya, lihat Format Gambar Faks.

Untuk memberi tahu layanan faks bahwa panggilan telah dibuat, FSP harus memanggil fungsi FaxSendCallback yang ditunjukkan oleh parameter FaxSendCallback . Fungsi panggilan balik juga menyediakan layanan faks dengan handel panggilan yang ditetapkan TAPI. Handel ini diperlukan untuk perutean pesan TAPI. Jika FSP tidak memanggil FaxSendCallback, FSP akan melewatkan semua peristiwa khusus panggilan untuk operasi pengiriman.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	faxdev.h

Lihat juga

FAX_SEND

Fungsi Penyedia Layanan Faks

FaxDevReceive

FaxDevStartJob

FaxSendCallback

Menggunakan API Penyedia Layanan Faks