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