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

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

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

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

语法

HRESULT Populate(
  IStream *contentStream
);

参数

contentStream

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

返回值

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

要求

要求 价值
标头 dbgmodel.h

另请参阅

IDataModelScript2 接口