ConfigureModule.ProvideTextData 方法
Mergemod.dll會呼叫 ProvideTextData 方法,以從用戶端工具擷取文字資料。 Mergemod.dll從 ModuleConfiguration 資料表中的對應專案提供 Name 。
此工具應該會傳回S_OK,並在 ConfigData 中提供適當的自訂文字。 用戶端工具負責配置資料,但 Mergemod.dllis 負責釋放記憶體。 這個引數必須是 BSTR 物件。 不接受LPCWSTR。
如果此工具未提供此 Name 值的任何組態資料,函式應該會傳回S_FALSE。 在此情況下,Mergemod.dll忽略 ConfigData 引數的值,並使用 ModuleConfiguration 資料表中的預設值。
S_OK或S_FALSE以外的任何傳回碼,如果記錄檔已開啟) ,且會導致合併失敗,就會 (記錄錯誤。
由於此函式遵循標準 BSTR 慣例,所以 null 相當於空字串。
語法
ConfigureModule.ProvideTextData(
Name,
ConfigData
)
參數
-
名稱
-
正在擷取資料的專案名稱。
-
ConfigData
-
自訂文字的指標。
傳回值
這個方法不會傳回值。
備註
針對 ModuleConfiguration 資料表中的每個記錄,用戶端可以呼叫一次以上。 請注意,Mergemod.dll永遠不會針對相同的 「Name」 值對用戶端進行多個呼叫。 如果 ModuleSubstitution 資料表中沒有記錄使用 屬性,則 ModuleConfiguration 資料表中的專案不會呼叫用戶端。
C++
請參閱 ProvideTextData 函式。
規格需求
需求 | 值 |
---|---|
版本 |
Mergemod.dll 2.0 或更新版本 |
標頭 |
|
DLL |
|