IMsmConfigureModule::P rovideTextData メソッド (mergemod.h)

ProvideTextData メソッドは、クライアント ツールからテキスト データを取得します。 詳細については、ConfigureModule オブジェクトの ProvideTextData メソッドを参照してください。

構文

HRESULT ProvideTextData(
  [in]  const BSTR Name,
  [out] BSTR       *ConfigData
);

パラメーター

[in] Name

ツールがこの値の構成データを提供しない場合、関数はS_FALSEを返す必要があります。 この場合、Mergemod.dll は ConfigData 引数の値を無視し、ModuleConfiguration テーブルの既定値を使用します。

[out] ConfigData

ツールはS_OKを返し、 ConfigData で適切なカスタマイズ テキストを指定する必要があります。 クライアント ツールはデータの割り当てを担当しますが、Mergemod.dll はメモリの解放を担当します。 この引数は BSTR オブジェクトである必要があります。 LPCWSTR は受け入れられません。

戻り値

S_OKまたはS_FALSE以外の戻りコードを実行すると、エラーがログに記録され (ログが開いている場合)、マージが失敗します。

解説

クライアントは、ModuleConfiguration テーブルのレコードごとに 1 回だけ呼び出すことができます。 Mergemod.dll は、同じ "Name" 値に対してクライアントを複数回呼び出すことはないことに注意してください。 このプロパティを使用するレコードが ModuleSubstitution テーブル内にない場合、ModuleConfiguration テーブル内のエントリによるクライアントへの呼び出しは行われません。

要件

こちらもご覧ください

IMsmConfigureModule

マージ モジュールのオートメーション