Método IDataModelScript2::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 script 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 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 Popular e Executar. Ele deve sincronizar qualquer estado interno e estruturas de dados para "lembrar" o conteúdo do script após o retorno da chamada Popular.
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.
Valor de retorno
Esse método retorna HRESULT que indica êxito ou falha.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | dbgmodel.h |