Método IDataModelScript2::P opulate (dbgmodel.h)

El cliente llama al método Populate para cambiar o sincronizar el "contenido" del script. Es la notificación que se realiza al proveedor de scripts que ha cambiado el código del script. Es importante tener en cuenta que este método no provoca la ejecución del script ni los cambios en ninguno de los objetos que manipula el script. Esto es simplemente una notificación al proveedor de scripts que el contenido del script ha cambiado para que pueda sincronizar su propio estado interno.

Es posible que el implementador del método Populate no contenga la secuencia de contenido entre las llamadas Rellenar y Ejecutar. Debe sincronizar cualquier estado interno y estructuras de datos para "recordar" el contenido del script después de que se devuelva la llamada Rellenar.

También es importante tener en cuenta que la implementación no debe descartar el estado que representa la versión ejecutada actualmente del script hasta después de que una llamada Execute se realice correctamente. Si el contenido rellenado tiene sintaxis u otros errores que impiden la ejecución correcta del script, el proveedor debe restaurar el estado del script a lo que se ejecutó correctamente.

Sintaxis

HRESULT Populate(
  IStream *contentStream
);

Parámetros

contentStream

Aquí se pasa un flujo de entrada estándar que representa el contenido de todo el script. La implementación debe "recordar" este contenido (o una forma basada en la estructura de datos) después de que el método Populate devuelva. Es ilegal contener una referencia a la secuencia pasada después de devolver. Esto provocará un comportamiento indefinido en el host.

Valor devuelto

Este método devuelve HRESULT que indica éxito o error.

Requisitos

Requisito	Valor
encabezado de	dbgmodel.h

Consulte también

de interfaz IDataModelScript2 de