Método IDataModelScript::P opulate (dbgmodel.h)
O método Populate é chamado pelo cliente para alterar ou sincronizar o "conteúdo" do script. É a notificação feita ao provedor de scripts de que o código do script foi alterado. É importante observar que esse método não causa a execução do script ou alterações em nenhum dos objetos que o script manipula. Isso é apenas uma notificação para o provedor de script de que o conteúdo do script foi alterado para que ele possa sincronizar seu próprio estado interno.
O implementador do método Populate pode não conter o fluxo de conteúdo entre as chamadas Populate e Execute. Ele deve sincronizar qualquer estado interno e estruturas de dados para "lembrar" o conteúdo do script após o retorno da chamada Preencher.
Também é importante observar que a implementação não deve descartar o estado que representa a versão atualmente executada do script até que uma chamada Execute seja bem-sucedida. Se o conteúdo preenchido tiver sintaxe ou outros erros que impeçam a execução bem-sucedida do script, o provedor deverá restaurar o estado do script para o que foi executado com êxito.
Sintaxe
HRESULT Populate(
IStream *contentStream
);
Parâmetros
contentStream
Um fluxo de entrada padrão que representa o conteúdo de todo o script é passado aqui. A implementação deve "lembrar" esse conteúdo (ou uma forma baseada em estrutura de dados) depois que o método Populate retornar. É ilegal manter uma referência ao fluxo passado depois de retornar. Isso causará um comportamento indefinido no host.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |