iDataModelScript::P opulate 方法 (dbgmodel.h)
客户端调用 Populate 方法以更改或同步脚本的“内容”。 这是向脚本提供程序发出的脚本代码已更改的通知。 请务必注意,此方法不会导致脚本的执行或更改脚本操作的任何对象。 这只是向脚本提供程序发送的通知,告知脚本的内容已更改,以便它可以同步自己的内部状态。
Populate 方法的实现者可能不会保存 Populate 和 Execute 调用之间的内容流。 它必须同步任何内部状态和数据结构,以在 Populate 调用返回后“记住”脚本内容。
同样需要注意的是,在 Execute 调用成功之前,实现不应放弃表示当前执行的脚本版本的状态。 如果填充的内容具有阻止脚本成功执行的语法或其他错误,则提供程序必须将脚本的状态还原为已成功执行的内容。
语法
HRESULT Populate(
IStream *contentStream
);
参数
contentStream
此处传递表示整个脚本内容的标准输入流。 在 Populate 方法返回后,实现必须“记住”此内容 (或其基于数据结构的形式) 。 返回后保留对传递的流的引用是非法的。 这样会导致主机中出现未定义的行为。
返回值
此方法返回指示成功或失败的 HRESULT。
要求
要求 | 值 |
---|---|
Header | dbgmodel.h |