IProcessInitializer Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Admite métodos a los que se puede llamar cuando se inicia o cierra un componente COM.
public interface class IProcessInitializer
[System.Runtime.InteropServices.Guid("1113f52d-dc7f-4943-aed6-88d04027e32a")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IProcessInitializer
[<System.Runtime.InteropServices.Guid("1113f52d-dc7f-4943-aed6-88d04027e32a")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IProcessInitializer = interface
Public Interface IProcessInitializer
- Derivado
- Atributos
Comentarios
Implemente los IProcessInitializer métodos de interfaz en los componentes con servicio si desea ejecutar el código de inicialización o apagado cuando se inicia o apaga un proceso de servidor (Dllhost.exe), respectivamente.
COM+ proporciona Startup
eventos y Shutdown
cuando se inicia y finaliza Dllhost.exe. Esta característica permite que los componentes COM+ instalados en una aplicación de servidor COM+ (denominados componentes de servidor en adelante) ejecuten la inicialización personalizada y limpien el código. Se creará y almacenará una instancia de cada componente que implemente la IProcessInitializer interfaz durante el proceso. Cuando se implementa en , ServicedComponentel InitializesServerApplication
parámetro de la COMAdminCatalogObject
colección Components debe establecerse true
en durante el registro del componente, para que se llame a los métodos de interfaz durante el inicio y el apagado.
Con los Startup
eventos y Shutdown
, puede inicializar recursos, crear conexiones, inicializar datos compartidos y ejecutar código de limpieza. Sin embargo, no debe tener acceso a los estados específicos de COM+ porque aún no se han creado instancias de componentes de servidor. Además, el código de los Startup
eventos y Shutdown
debe devolverse lo antes posible, ya que el sistema espera solo 90 segundos para Dllhost.exe prepararse para aceptar activaciones después de que el sistema inicie el proceso. Si Dllhost.exe no señala que está listo en un plazo de 90 segundos, el sistema finaliza el proceso; por lo tanto, todo el procesamiento de inicialización debe completarse dentro de este período de tiempo. Cada componente de servidor que participa en la inicialización debe admitir la IProcessInitializer interfaz . En DllHost.exe inicio, COM+ crea todos los componentes de servidor que solicitaron este servicio, llama QueryInterface
a la IProcessInitializer interfaz y llama a la Startup función . De forma similar, cuando se apaga el proceso de DllHost.exe, llama a la Shutdown función en los punteros de interfaz almacenados previamente.
Métodos
Shutdown() |
Realiza acciones de cierre. Se le llama cuando se cierra Dllhost.exe. |
Startup(Object) |
Realiza la inicialización cuando se inicia. Se le llama cuando se inicia Dllhost.exe. |