Metodo IDataModelScript::P opulate (dbgmodel.h)
Il metodo Popolamento viene chiamato dal client per modificare o sincronizzare il "contenuto" dello script. Si tratta della notifica effettuata al provider di script che il codice dello script è stato modificato. È importante notare che questo metodo non causa l'esecuzione dello script o le modifiche a uno degli oggetti che lo script modifica. Si tratta semplicemente di una notifica al provider di script che il contenuto dello script è cambiato in modo che possa sincronizzare il proprio stato interno.
L'implementazione del metodo Popolamento potrebbe non contenere il flusso di contenuto tra le chiamate Popolamento e Execute. Deve sincronizzare qualsiasi stato interno e strutture di dati per "ricordare" il contenuto dello script dopo che la chiamata Popolamento restituisce.
È anche importante notare che l'implementazione non deve ignorare lo stato che rappresenta la versione attualmente eseguita dello script fino a quando non viene completata una chiamata Esegui. Se il contenuto popolato ha sintassi o altri errori che impediscono l'esecuzione corretta dello script, il provider deve ripristinare lo stato dello script a ciò che è stato eseguito correttamente.
Sintassi
HRESULT Populate(
IStream *contentStream
);
Parametri
contentStream
Un flusso di input standard che rappresenta il contenuto dell'intero script viene passato qui. L'implementazione deve "ricordare" questo contenuto (o una forma basata sulla struttura dei dati) dopo che il metodo Popolamento restituisce. Non è consentito contenere un riferimento al flusso passato dopo la restituzione. Tale comportamento causerà un comportamento non definito nell'host.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o l'errore.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dbgmodel.h |