Metode IFaxServer::CreateDocument (faxcom.h)

Metode IFaxServer::CreateDocument membuat objek FaxDoc untuk objek FaxServer tertentu. Objek FaxDoc memungkinkan pengguna untuk membuat dan mengirimkan dokumen ke satu atau beberapa penerima faks.

Sintaks

HRESULT CreateDocument(
  [in]  BSTR    FileName,
  [out] VARIANT *retval
);

Parameter

[in] FileName

Jenis: BSTR

Menentukan string yang dihentikan null yang berisi jalur dan nama file yang sepenuhnya memenuhi syarat yang berisi dokumen faks yang akan ditransmisikan. Jalur dapat berupa jalur UNC atau jalur yang dimulai dengan huruf kandar.

Parameter ini dapat berisi nama file lokal atau jarak jauh yang valid. File harus merupakan tipe file yang terdaftar dengan benar, dan server faks harus dapat mengakses file.

[out] retval

Jenis: VARIAN*

Penunjuk ke struktur VARIAN yang menerima penunjuk antarmuka IDispatch ke objek FaxDoc . Metode mengembalikan anggota pdispVal dengan jenis data VT_DISPATCH.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode IFaxServer::CreateDocument mengambil penunjuk antarmuka IDispatch ke objek FaxDoc . Aplikasi klien faks juga dapat mengakses antarmuka IFaxDoc secara langsung dengan memanggil metode IUnknown::QueryInterface untuk mengambil penunjuk antarmuka. Antarmuka IFaxDoc memungkinkan pengguna untuk mengatur properti untuk dokumen faks, lalu mengirimkan dokumen.

Aplikasi klien faks tidak boleh memanggil fungsi CoCreateInstance untuk mengambil penunjuk antarmuka IFaxDoc karena tidak akan dibuat dengan benar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	faxcom.h
DLL	Faxcom.dll

Lihat juga

Antarmuka API Klien Layanan Faks

FAX Service Client API untuk Windows 2000

FaxDoc

FaxServer

IFaxServer

IUnknown::QueryInterface