Metode ConfigureModule.ProvideTextData

Metode ProvideTextData dipanggil oleh Mergemod.dll untuk mengambil data teks dari alat klien. Mergemod.dll menyediakan Nama dari entri terkait dalam tabel ModuleConfiguration.

Alat ini harus mengembalikan S_OK dan memberikan teks kustomisasi yang sesuai di ConfigData. Alat klien bertanggung jawab untuk mengalokasikan data, tetapi Mergemod.dllis bertanggung jawab untuk merilis memori. Argumen ini HARUS berupa objek BSTR . LPCWSTR TIDAK diterima.

Jika alat tidak menyediakan data konfigurasi apa pun untuk nilai Nama ini, fungsi harus mengembalikan S_FALSE. Dalam hal ini Mergemod.dll mengabaikan nilai argumen ConfigData dan menggunakan nilai Default dari tabel ModuleConfiguration.

Setiap kode pengembalian selain S_OK atau S_FALSE akan menyebabkan kesalahan dicatat (jika log terbuka) dan akan mengakibatkan penggabungan gagal.

Karena fungsi ini mengikuti konvensi BSTR standar, null setara dengan string kosong.

ConfigureModule.ProvideTextData(
  Name,
  ConfigData
)

Nama

Nama item yang datanya sedang diambil.

ConfigData

Arahkan ke teks kustomisasi.

Metode ini tidak mengembalikan nilai.

Klien dapat dipanggil tidak lebih dari sekali untuk setiap rekaman dalam tabel ModuleConfiguration. Perhatikan bahwa Mergemod.dll tidak pernah melakukan beberapa panggilan ke klien untuk nilai "Nama" yang sama. Jika tidak ada rekaman dalam tabel ModuleSubstitution yang menggunakan properti , entri dalam tabel ModuleConfiguration tidak menyebabkan panggilan ke klien.

Lihat Fungsi ProvideTextData.