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

Если скрипт имеет "основную функцию", которая предназначена для выполнения из вызова пользовательского интерфейса, она указывает на это с помощью истинного возврата из метода IsInvocable. Затем пользовательский интерфейс может вызвать метод InvokeMain, чтобы фактически вызвать скрипт. Обратите внимание, что это отличается от Execute, которая выполняет весь корневой код и мостит скрипт к пространству имен базового узла.

Этот метод может завершиться ошибкой E_NOTIMPL если скрипт не содержит "основную функцию" или поставщик не определяет такой.

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

Если во время выполнения скрипта возникают ошибки или другие события, такие (и их расположение в скрипте) могут передаваться через канал связи между IDataModelScript и IDataModelScriptClient.

Синтаксис

HRESULT InvokeMain(
  IDataModelScriptClient *client
);

Параметры

client

Интерфейс для клиента, который запрашивает вызов основной функции. Если во время выполнения основной функции возникают ошибки или другие события, скрипт может передать эти сведения и его расположение в скрипте обратно клиенту с помощью вызовов метода в этом интерфейсе.

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

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

Требования

См. также

интерфейса IDataModelScript