次の方法で共有

Merge.MergeEx メソッド

  • [アーティクル]

Merge オブジェクトの MergeEx メソッドは、追加の引数を受け取る点を除いて Merge 関数と同等です。 pConfiguration 引数は、クライアントによって実装されるインターフェイスです。 この引数は null にできます。 この引数が存在する場合は、クライアントが構成機能をサポートできることを示していますが、クライアントは特定の構成可能な項目の構成データを提供する必要はありません。

Merge メソッドは、現在のデータベースと現在のモジュールのマージを実行します。 このマージによって、モジュール内のコンポーネントが Feature によって識別される機能にアタッチされます。 モジュールのディレクトリ ツリーのルートは、RedirectDir によって指定されている場所にリダイレクトされます。

構文

Merge.MergeEx(
  Feature,
  RedirectDir,
  pConfiguration
)

パラメーター

機能

データベース内の機能の名前。

RedirectDir

データベースの Directory テーブル内のエントリのキー。 このパラメーターは null または空の文字列にできます。

pConfiguration

pConfiguration 引数は、クライアントによって実装されるインターフェイスです。 この引数は null にできます。 この引数が存在する場合は、クライアントが構成機能をサポートできることを示していますが、クライアントは特定の構成可能な項目の構成データを提供する必要はありません。

戻り値

このメソッドは値を返しません。

解説

マージが完了すると、モジュール内のコンポーネントは Feature によって識別される機能にアタッチされます。 この機能は、作成されるのではなく、既存の機能である必要があります。 このモジュールは、Connect メソッドを使用して、追加機能にアタッチできます。

データベースに加えられた変更は、CloseDatabase メソッドが、bCommit を TRUE に設定した状態で呼び出された場合にのみ保存されます。

何らかのマージの競合 (除外を含む) が発生した場合、それらは後で取得するためにエラー列挙子に配置されますが、それによりマージが失敗するわけではありません。 エラーは、Errors プロパティを使用して取得できます。 エラーと情報メッセージは、現在のログ ファイルに送信されます。

が正しくないためにマージが失敗した場合、MergeEx 関数は E_FAIL を返します。 これには、msmErrorBadNullSubstitution、msmErrorBadSubstitutionType、msmErrorBadNullResponse、msmErrorMissingConfigItem、msmErrorDataRequestFailed という msmErrorType エラーが含まれます。 これらのエラーの場合は、エラーが発生すると、マージは直ちに停止されます。 MergeEx が E_FAIL を返した場合は、エラー オブジェクトが引き続き列挙子に追加されます。 msmErrorType エラーの詳細については、get_Type 関数 (Error オブジェクト) に関するページを参照してください。 その他のすべてのエラーの場合、MergeEx は S_FALSE を返し、マージが続行されます。

C++

MergeEx 関数に関するページを参照してください。

必要条件

要件 値
バージョン
 Mergemod.dll 2.0 以降
ヘッダー
Mergemod.h
[DLL]
Mergemod.dll