IDataModelScript::P opulate メソッド (dbgmodel.h)
スクリプトの "コンテンツ" を変更または同期するために、クライアントによって Populate メソッドが呼び出されます。 スクリプトのコードが変更されたことをスクリプト プロバイダーに通知します。 このメソッドによってスクリプトが実行されたり、スクリプトによって操作されるオブジェクトが変更されたりしないことに注意することが重要です。 これは、スクリプトの内容が変更され、独自の内部状態が同期される可能性があることをスクリプト プロバイダーに通知するだけです。
Populate メソッドの実装者は、Populate 呼び出しと Execute 呼び出しの間にコンテンツ ストリームを保持できない場合があります。 Populate 呼び出しが返された後、スクリプトの内容を "記憶" するために、内部状態とデータ構造を同期する必要があります。
また、Execute 呼び出しが成功するまで、実装で現在実行されているバージョンのスクリプトを表す状態を破棄しないことにも注意してください。 設定されたコンテンツに、スクリプトの正常な実行を妨げる構文やその他のエラーがある場合、プロバイダーはスクリプトの状態を正常に実行された内容に復元する必要があります。
構文
HRESULT Populate(
IStream *contentStream
);
パラメーター
contentStream
スクリプト全体の内容を表す標準入力ストリームがここで渡されます。 実装では、Populate メソッドが戻った後に、このコンテンツ (またはデータ構造ベースの形式) を "記憶" する必要があります。 戻った後に渡されたストリームへの参照を保持することは無効です。 これにより、ホストで未定義の動作が発生します。
戻り値
このメソッドは、成功または失敗を示す HRESULT を返します。
要件
| 要件 | 値 |
|---|---|
| Header | dbgmodel.h |