IDataModelScript::P opulate-Methode (dbgmodel.h)
Die Populate-Methode wird vom Client aufgerufen, um den "Inhalt" des Skripts zu ändern oder zu synchronisieren. Es ist die Benachrichtigung, die an den Skriptanbieter gesendet wird, dass der Code des Skripts geändert wurde. Es ist wichtig zu beachten, dass diese Methode keine Ausführung des Skripts oder Änderungen an den Objekten verursacht, die das Skript bearbeitet. Dies ist lediglich eine Benachrichtigung an den Skriptanbieter, dass sich der Inhalt des Skripts geändert hat, sodass er seinen eigenen internen Zustand synchronisieren kann.
Der Implementierer der Populate-Methode enthält möglicherweise nicht den Inhaltsdatenstrom zwischen den Aufrufen "Populate" und "Execute". Es muss alle internen Zustands- und Datenstrukturen synchronisieren, um sich den Skriptinhalt zu "merken", nachdem der Auffüllaufruf zurückgegeben wird.
Es ist auch wichtig zu beachten, dass die Implementierung den Zustand, der die aktuell ausgeführte Version des Skripts darstellt, erst verwerfen sollte, nachdem ein Execute-Aufruf erfolgreich war. Wenn der aufgefüllte Inhalt Syntaxfehler oder andere Fehler aufweist, die eine erfolgreiche Ausführung des Skripts verhindern, muss der Anbieter den Status des Skripts auf den zustand wiederherstellen, der erfolgreich ausgeführt wurde.
Syntax
HRESULT Populate(
IStream *contentStream
);
Parameter
contentStream
Hier wird ein Standardeingabestream übergeben, der den Inhalt des gesamten Skripts darstellt. Die Implementierung muss sich diesen Inhalt (oder eine datenstrukturbasierte Form davon) "merken", nachdem die Populate-Methode zurückgegeben wurde. Es ist unzulässig, nach der Rückgabe einen Verweis auf den übergebenen Stream zu enthalten. Dies führt zu undefiniertem Verhalten auf dem Host.
Rückgabewert
Diese Methode gibt HRESULT zurück, das auf Erfolg oder Fehler hinweist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |