IProcessInitializer Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Supporta i metodi che è possibile chiamare quando un componente COM viene avviato o arrestato.
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 = interfacePublic Interface IProcessInitializer- Derivato
- Attributi
Commenti
Implementare i IProcessInitializer metodi di interfaccia nei componenti serviti se si vuole eseguire rispettivamente l'inizializzazione o l'arresto del codice quando un processo del server (Dllhost.exe) viene avviato o arrestato.
COM+ fornisce Startup eventi e Shutdown all'avvio e alla fine dell'Dllhost.exe. Questa funzionalità consente a tutti i componenti COM+ installati in un'applicazione server COM+ (denominata qui dopo i componenti server) di eseguire l'inizializzazione personalizzata e pulire il codice. Verrà creata e archiviata un'istanza di ogni componente che implementa l'interfaccia IProcessInitializer per la durata del processo. Se implementato in un ServicedComponentoggetto , il InitializesServerApplication parametro nell'insieme COMAdminCatalogObject Components deve essere impostato su true durante la registrazione del componente, in modo che i metodi di interfaccia vengano chiamati durante l'avvio e l'arresto.
Usando gli Startup eventi e Shutdown è possibile inizializzare le risorse, creare connessioni, inizializzare i dati condivisi ed eseguire il codice di pulizia. Tuttavia, non è necessario accedere agli stati specifici di COM+ perché le istanze dei componenti del server non sono ancora state create. Inoltre, il codice negli Startup eventi e Shutdown deve restituire il più rapidamente possibile, perché il sistema attende solo 90 secondi per Dllhost.exe di preparare l'accettazione delle attivazioni dopo l'avvio del processo da parte del sistema. Se Dllhost.exe non segnala che è pronto entro 90 secondi, il sistema termina il processo; pertanto, tutte le elaborazioni di inizializzazione devono essere completate entro questo intervallo di tempo. Ogni componente server che partecipa all'inizializzazione deve supportare l'interfaccia IProcessInitializer . All'avvio DllHost.exe, COM+ crea tutti i componenti server che hanno richiesto questo servizio, chiama QueryInterface l'interfaccia IProcessInitializer e chiama la Startup funzione. Analogamente, quando il processo di DllHost.exe viene arrestato, chiama la Shutdown funzione su tali puntatori di interfaccia archiviati in precedenza.
Metodi
| Shutdown() |
Esegue azioni di arresto. Chiamato quando Dllhost.exe viene arrestato. |
| Startup(Object) |
Esegue l'inizializzazione all'avvio. Chiamato quando Dllhost.exe viene avviato. |
