Fungsi panggilan balik MAPISENDDOCUMENTS (mapi.h)

[Penggunaan fungsi ini tidak dianjurkan. Ini bisa diubah atau tidak tersedia dalam versi Windows berikutnya.]

Fungsi MAPISendDocuments mengirimkan pesan standar dengan satu atau beberapa file terlampir dan catatan sampul. Catatan sampul adalah kotak dialog yang memungkinkan pengguna memasukkan daftar penerima dan pesan opsional. MAPISendDocuments berbeda dari fungsi MAPISendMail karena memungkinkan lebih sedikit fleksibilitas dalam pembuatan pesan.

Sintaks

MAPISENDDOCUMENTS Mapisenddocuments;

ULONG Mapisenddocuments(
  [in] ULONG_PTR ulUIParam,
  [in] LPSTR lpszDelimChar,
  [in] LPSTR lpszFilePaths,
  [in] LPSTR lpszFileNames,
       ULONG ulReserved
)
{...}

Parameter

[in] ulUIParam

Handel jendela induk atau nol, menunjukkan bahwa jika kotak dialog ditampilkan, itu adalah modal aplikasi. Jika parameter ulUIParam berisi handel jendela induk, parameter tersebut berjenis HWND (dilemparkan ke ULONG_PTR). Jika tidak ada kotak dialog yang ditampilkan selama panggilan, ulUIParam diabaikan.

[in] lpszDelimChar

Penunjuk ke karakter yang digunakan pemanggil untuk memisahkan nama yang ditunjukkan oleh parameter lpszFullPaths dan lpszFileNames . Pemanggil harus memilih karakter untuk pemisah yang tidak digunakan dalam nama file sistem operasi.

[in] lpszFilePaths

Penunjuk ke string yang berisi daftar jalur lengkap (termasuk huruf drive) ke file lampiran. Daftar ini dibentuk dengan menggabungkan jalur file yang dibentuk dengan benar yang dipisahkan oleh karakter yang ditentukan dalam parameter lpszDelimChar dan diikuti oleh terminator null . Contoh daftar yang valid adalah:

C:\TMP\TEMP1.DOC;C:\TMP\TEMP2.DOC

File yang ditentukan dalam parameter ini ditambahkan ke pesan sebagai lampiran file. Jika parameter ini NULL atau berisi string kosong, kotak dialog Kirim Catatan ditampilkan tanpa file terlampir.

[in] lpszFileNames

Penunjuk ke daftar nama file asli yang dihentikan null karena akan muncul dalam pesan. Ketika beberapa nama ditentukan, daftar dibentuk dengan menggabungkan nama file yang dipisahkan oleh karakter yang ditentukan dalam parameter lpszDelimChar dan diikuti dengan terminator null . Contohnya adalah:

TEMP3.DOC;TEMP4.DOC

Jika tidak ada nilai untuk parameter lpszFileNames atau jika kosong, MAPISendDocuments mengatur nama file yang diatur ke nilai nama file yang ditunjukkan oleh parameter lpszFullPaths .

ulReserved

Dipesan; harus nol.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
MAPI_E_ATTACHMENT_OPEN_FAILURE	Satu atau beberapa file dalam parameter lpszFilePaths tidak dapat ditemukan. Tidak ada pesan yang dikirim.
MAPI_E_ATTACHMENT_WRITE_FAILURE	Lampiran tidak dapat ditulis ke file sementara. Periksa izin direktori.
MAPI_E_FAILURE	Terjadi satu atau beberapa kesalahan yang tidak ditentukan saat mengirim pesan. Tidak diketahui apakah pesan dikirim.
MAPI_E_INSUFFICIENT_MEMORY	Memori tidak cukup untuk melanjutkan.
MAPI_E_LOGIN_FAILURE	Tidak ada log masuk default, dan pengguna gagal masuk dengan sukses ketika kotak dialog masuk ditampilkan. Tidak ada pesan yang dikirim.
MAPI_E_USER_ABORT	Pengguna membatalkan salah satu kotak dialog. Tidak ada pesan yang dikirim.
SUCCESS_SUCCESS	Panggilan berhasil dan pesan dikirim.

Keterangan

Fungsi MAPISendDocuments mengirim pesan standar, selalu menampilkan kotak dialog catatan sampul sehingga pengguna dapat menyediakan penerima dan opsi pengiriman lainnya. Fungsi ini mencoba membuat sesi menggunakan sesi bersama sistem olahpesan. Jika tidak ada sesi bersama, sesi tersebut meminta pengguna untuk informasi masuk untuk membuat sesi. Sebelum MAPISendDocuments kembali, sesi berakhir.

Lampiran pesan dapat menyertakan dokumen aktif atau semua dokumen yang saat ini terbuka di aplikasi klien yang disebut MAPISendDocuments. Fungsi ini digunakan terutama untuk panggilan dari makro atau bahasa skrip, sering ditemukan dalam aplikasi seperti spreadsheet atau program pemrosesan kata.

MAPISendDocuments membuat lampiran file sebanyak ada jalur yang ditentukan oleh parameter lpszFullPaths terlepas dari fakta bahwa mungkin ada sejumlah jalur dan nama file yang berbeda. Pemanggil bertanggung jawab untuk menghapus file sementara yang dibuat saat menggunakan MAPISendDocuments.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	mapi.h

Lihat juga

MAPISendMail

MAPI Sederhana