Fungsi panggilan balik PFAXROUTEMETHOD (faxroute.h)

Artikel
08/23/2023

Fungsi FaxRouteMethod adalah tempat penampung untuk nama fungsi yang ditentukan oleh DLL ekstensi perutean faks. Fungsi ini menjalankan prosedur perutean faks yang ditentukan.

DLL ekstensi perutean faks dapat mengekspor beberapa metode perutean faks. Ekstensi perutean faks harus mengekspor satu fungsi faksRouteMethod bernama unik untuk setiap metode perutean faks yang diekspornya. Disarankan agar setiap nama fungsi menjelaskan fungsionalitas metode perutean faks tertentu. Layanan faks memanggil fungsi FaxRouteMethod , dalam urutan prioritas, setelah layanan menerima dokumen faks.

Sintaks

PFAXROUTEMETHOD Pfaxroutemethod;

BOOL Pfaxroutemethod(
  const FAX_ROUTE *unnamedParam1,
  PVOID *unnamedParam2,
  LPDWORD unnamedParam3
)
{...}

Parameter

unnamedParam1

Jenis: const FAX_ROUTE*

Penunjuk ke struktur FAX_ROUTE yang berisi informasi tentang dokumen faks yang diterima.

unnamedParam2

Jenis: PVOID*

Penunjuk ke variabel yang menerima penunjuk ke buffer yang berisi informasi coba lagi untuk metode perutean faks. Parameter ini bisa sama dengan NULL. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

unnamedParam3

Jenis: LPDWORD

Penunjuk ke variabel DWORD yang tidak ditandatangani yang menerima ukuran, dalam byte, dari buffer yang diarahkan oleh parameter FailureData .

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

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

Keterangan

Metode perutean faks dapat memanipulasi file Tagged Image File Format Class F (TIFF Class F) yang diterima. Misalnya, satu metode perutean dapat merutekan file Tagged Image File Format (TIFF) yang diterima ke tujuan tertentu seperti printer, atau mengirimkan file dalam pesan email kepada pengguna. Metode perutean lain dapat mengonversi file TIFF menjadi teks menggunakan teknologi pengenalan karakter optik (OCR), lalu membuat dokumen Microsoft Word dari teks. Metode perutean faks tidak dapat menghapus atau mengubah file TIFF. Untuk informasi tentang file TIFF, lihat Format Gambar Faks..

Jika Anda ingin layanan faks mencoba kembali metode perutean yang gagal di lain waktu, metode perutean faks harus mengambil langkah-langkah berikut.

Untuk menentukan bahwa layanan faks mencoba kembali metode perutean faks

Alokasikan buffer untuk menyimpan informasi coba lagi untuk metode perutean faks. Metode perutean faks harus mengalokasikan memori yang diperlukan untuk buffer dari heap yang ditentukan oleh fungsi FaxRouteInitialize .
Isi buffer dengan informasi yang diperlukan untuk mencoba kembali metode perutean faks.
Atur parameter FailureData dari fungsi FaxRouteMethod ke nilai penunjuk yang valid.

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	faxroute.h