Metodo IDataModelScript2::P opulate (dbgmodel.h)

Il metodo Populate viene chiamato dal client per modificare o sincronizzare il "contenuto" dello script. Si tratta della notifica inviata 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 modificati dallo script. Si tratta semplicemente di una notifica al provider di script che il contenuto dello script è stato modificato in modo che possa sincronizzare il proprio stato interno.

L'implementatore del metodo Populate 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 la restituzione della chiamata Popolamento.

È anche importante notare che l'implementazione non deve eliminare lo stato che rappresenta la versione attualmente eseguita dello script fino a quando una chiamata Execute ha esito positivo. Se il contenuto popolato presenta sintassi o altri errori che impediscono l'esecuzione corretta dello script, il provider deve ripristinare lo stato dello script in quello che è stato eseguito correttamente.

Sintassi

HRESULT Populate(
  IStream *contentStream
);

Parametri

contentStream

Qui viene passato un flusso di input standard che rappresenta il contenuto dell'intero script. L'implementazione deve "ricordare" questo contenuto (o una forma basata su una struttura di dati) dopo che il metodo Populate restituisce. Non è consentito contenere un riferimento al flusso passato dopo la restituzione. Questo causerà un comportamento non definito nell'host.

Valore restituito

Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.

Fabbisogno

Requisito	Valore
intestazione	dbgmodel.h

Vedere anche

dell'interfaccia IDataModelScript2