Поделиться через


Метод IDataModelScript::P opulate (dbgmodel.h)

Метод Заполнение вызывается клиентом для изменения или синхронизации "содержимого" скрипта. Поставщику скрипта отправляется уведомление об изменении кода скрипта. Важно отметить, что этот метод не приводит к выполнению скрипта или изменению каких-либо объектов, которыми управляет скрипт. Это просто уведомление для поставщика скрипта о том, что содержимое скрипта изменилось, чтобы он мог синхронизировать собственное внутреннее состояние.

Разработчик метода Заполнение может не содержать поток содержимого между вызовами Заполнение и Выполнение. Он должен синхронизировать все внутренние состояния и структуры данных, чтобы "запомнить" содержимое скрипта после возврата вызова Заполнение.

Важно также отметить, что реализация не должна сбрасывать состояние, представляющее текущую версию скрипта, до тех пор, пока вызов Execute не будет выполнен. Если заполненное содержимое содержит синтаксические или другие ошибки, препятствующие успешному выполнению скрипта, поставщик должен восстановить состояние скрипта до того, что было успешно выполнено.

Синтаксис

HRESULT Populate(
  IStream *contentStream
);

Параметры

contentStream

Сюда передается стандартный входной поток, представляющий содержимое всего скрипта. Реализация должна "запомнить" это содержимое (или форму на основе структуры данных) после возврата метода Заполнение. Хранение ссылки на переданный поток после возврата недопустимо. Это приведет к неопределенному поведению на узле.

Возвращаемое значение

Этот метод возвращает HRESULT, который указывает на успех или сбой.

Требования

Требование Значение
Заголовок dbgmodel.h

См. также раздел

Интерфейс IDataModelScript