IDataModelScript2 ::P opulate, méthode (dbgmodel.h)
La méthode Populate est appelée par le client pour modifier ou synchroniser le « contenu » du script. Il s’agit de la notification envoyée au fournisseur de script 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 à l’un des objets que le script manipule. Il s’agit simplement d’une notification au fournisseur de script 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 de remplissage et d’exécution. Il doit synchroniser les structures d’état interne et de données 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 jusqu’à ce qu’un appel d’exécution réussisse. Si le contenu rempli a 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é correctement exécuté.
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 une 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 de retour
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |