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

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

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

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

Синтаксис

HRESULT Populate(
  IStream *contentStream
);

Параметры

contentStream

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

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

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

Требования

См. также

интерфейса IDataModelScript