IDataModelScript ::P opulate, méthode (dbgmodel.h)
La méthode Populate est appelée par le client afin de modifier ou de synchroniser le « contenu » du script. Il s’agit de la notification envoyée au fournisseur de script indiquant que le code du script a changé. Il est important de noter que cette méthode n’entraîne pas l’exécution du script ou des modifications apportées aux objets que le script manipule. Il s’agit simplement d’une notification au fournisseur de script indiquant que le contenu du script a changé afin qu’il puisse synchroniser son propre état interne.
L’implémenteur de la méthode Populate peut ne pas contenir le flux de contenu entre les appels Remplir et Exécuter. Il doit synchroniser les structures d’état et de données internes pour « mémoriser » le contenu du script après le retour de l’appel de remplissage.
Il est également important de noter que l’implémentation ne doit pas ignorer l’état représentant la version actuellement exécutée du script tant qu’un appel d’exécution n’a pas réussi. Si le contenu rempli présente une syntaxe ou d’autres erreurs qui empêchent l’exécution réussie du script, le fournisseur doit restaurer l’état du script sur ce qui a été exécuté avec succès.
Syntaxe
HRESULT Populate(
IStream *contentStream
);
Paramètres
contentStream
Un flux d’entrée standard représentant le contenu de l’ensemble du script est passé ici. L’implémentation doit « mémoriser » ce contenu (ou une forme basée sur la structure de données) après le retour de la méthode Populate. Il est illégal de conserver une référence au flux passé après le retour. Cela entraîne un comportement non défini dans l’hôte.
Valeur retournée
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |