iDataModelScript::P opulate 方法 (dbgmodel.h)

客户端调用 Populate 方法以更改或同步脚本的“内容”。 这是向脚本提供程序发出的脚本代码已更改的通知。 请务必注意,此方法不会导致脚本的执行或更改脚本操作的任何对象。 这只是向脚本提供程序发送的通知,告知脚本的内容已更改,以便它可以同步自己的内部状态。

Populate 方法的实现者可能不会保存 Populate 和 Execute 调用之间的内容流。 它必须同步任何内部状态和数据结构,以在 Populate 调用返回后“记住”脚本内容。

同样需要注意的是,在 Execute 调用成功之前,实现不应放弃表示当前执行的脚本版本的状态。 如果填充的内容具有阻止脚本成功执行的语法或其他错误,则提供程序必须将脚本的状态还原为已成功执行的内容。

语法

HRESULT Populate(
  IStream *contentStream
);

参数

contentStream

此处传递表示整个脚本内容的标准输入流。 在 Populate 方法返回后,实现必须“记住”此内容 (或其基于数据结构的形式) 。 返回后保留对传递的流的引用是非法的。 这样会导致主机中出现未定义的行为。

返回值

此方法返回指示成功或失败的 HRESULT。

要求

要求
Header dbgmodel.h

另请参阅

IDataModelScript 接口