IDataModelScript::InvokeMain-Methode (dbgmodel.h)
Wenn das Skript über eine "Standard-Funktion" verfügt, die über einen Benutzeroberflächenaufruf ausgeführt werden soll, wird dies über eine true-Rückgabe der IsInvocable-Methode angegeben. Die Benutzeroberfläche kann dann die InvokeMain-Methode aufrufen, um das Skript tatsächlich aufzurufen. Beachten Sie, dass sich dies von Execute unterscheidet, das den gesamten Stammcode ausführt und das Skript mit dem Namespace des zugrunde liegenden Hosts überbrückt.
Diese Methode schlägt möglicherweise mit E_NOTIMPL fehl, wenn das Skript keine "Standard-Funktion" enthält oder der Anbieter diese nicht definiert.
Beachten Sie, dass eine Anwendung, die das Datenmodell hostet, ein Skript einmal laden und ausführen kann, aber die InvokeMain-Methode beliebig oft ohne einen dazwischen liegenden Execute-Aufruf aufruft. Es wird erwartet, dass dadurch der "Skriptkontext" erhalten bleibt, das Skript geladen bleibt und einfach eine Methode innerhalb des Skripts mehrmals aufgerufen wird.
Wenn während der Ausführung des Skripts Fehler oder andere Ereignisse auftreten, können solche (und ihre Position innerhalb des Skripts) über den Kommunikationskanal zwischen IDataModelScript und dem inpassierten IDataModelScriptClient übergeben werden.
Syntax
HRESULT InvokeMain(
IDataModelScriptClient *client
);
Parameter
client
Eine Schnittstelle zum Client, die den Aufruf der Standard-Funktion anfordert. Wenn während der Ausführung der Standard-Funktion Fehler oder andere Ereignisse auftreten, kann das Skript diese Informationen und ihren Speicherort innerhalb des Skripts über Methodenaufrufe auf dieser Schnittstelle zurück an den Client übergeben.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |