IDataModelScript::InvokeMain メソッド (dbgmodel.h)

スクリプトに UI 呼び出しから実行することを目的とした "main 関数" がある場合は、IsInvocable メソッドからの真の戻り値を使用してそのような関数を示します。 その後、ユーザー インターフェイスは InvokeMain メソッドを呼び出して、スクリプトを実際に "呼び出す" ことができます。 これは、すべてのルート コードを実行し、スクリプトを基になるホストの名前空間にブリッジする Execute とは異なります。

スクリプトに "main 関数" が含まれていないか、プロバイダーが定義していない場合、このメソッドは E_NOTIMPL で失敗する可能性があります。

データ モデルをホストするアプリケーションでは、スクリプトを 1 回読み込んで実行できますが、InvokeMain メソッドは、Execute 呼び出しを介入せずに任意の回数呼び出すことができます。 これにより、"スクリプト コンテキスト" が保持され、スクリプトが読み込まれた状態を維持し、スクリプト内でメソッドを複数回呼び出すだけであることが期待されます。

スクリプトの実行中に発生するエラーまたはその他のイベントがある場合は、IDataModelScript と IDataModelScriptClient の間の通信チャネルを介して渡すことができます。

構文

HRESULT InvokeMain(
  IDataModelScriptClient *client
);

パラメーター

client

main 関数の呼び出しを要求しているクライアントへのインターフェイス。 メイン関数の実行中に発生するエラーまたはその他のイベントがある場合、スクリプトは、このインターフェイスのメソッド呼び出しを使用して、スクリプト内のこの情報とその場所をクライアントに渡すことができます。

戻り値

このメソッドは、成功または失敗を示す HRESULT を返します。

必要条件

要件	価値
ヘッダー	dbgmodel.h

関連項目

IDataModelScript インターフェイス の