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