IDataModelScript2::P opulate メソッド (dbgmodel.h)

Populate メソッドは、スクリプトの "コンテンツ" を変更または同期するためにクライアントによって呼び出されます。 スクリプト のコードが変更されたことをスクリプト プロバイダーに通知します。 このメソッドでは、スクリプトの実行や、スクリプトが操作するオブジェクトへの変更は発生しないことに注意してください。 これは、スクリプトプロバイダーが独自の内部状態を同期できるようにスクリプトの内容が変更されたことを示す通知にすぎません。

Populate メソッドの実装者は、Populate 呼び出しと Execute 呼び出しの間にコンテンツ ストリームを保持できない場合があります。 Populate 呼び出しが返された後、スクリプトの内容を "記憶" するために、内部状態とデータ構造を同期する必要があります。

また、Execute 呼び出しが成功するまで、現在実行されているバージョンのスクリプトを表す状態を実装で破棄しないようにすることも重要です。 設定されたコンテンツにスクリプトの正常な実行を妨げる構文またはその他のエラーがある場合、プロバイダーはスクリプトの状態を正常に実行された内容に復元する必要があります。

構文

HRESULT Populate(
  IStream *contentStream
);

パラメーター

contentStream

スクリプト全体の内容を表す標準入力ストリームがここで渡されます。 実装では、Populate メソッドから制御が戻った後に、このコンテンツ (またはデータ構造ベースの形式) を "記憶" する必要があります。 返されたストリームへの参照を保持することは無効です。 これにより、ホストで未定義の動作が発生します。

戻り値

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

必要条件

要件	価値
ヘッダー	dbgmodel.h

関連項目

IDataModelScript2 インターフェイス の