Partager via


IProcessInitializer Interface

Définition

Prend en charge les méthodes pouvant être appelées lors du démarrage ou de l’arrêt d’un composant 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
Dérivé
Attributs

Remarques

Implémentez les IProcessInitializer méthodes d’interface sur les composants gérés si vous souhaitez exécuter du code d’initialisation ou d’arrêt lorsqu’un processus serveur (Dllhost.exe) démarre ou s’arrête, respectivement.

COM+ fournit des Startup événements et Shutdown lorsque Dllhost.exe commence et se termine. Cette fonctionnalité permet à tous les composants COM+ installés dans une application serveur COM+ (appelées composants serveur ci-après) d’exécuter une initialisation personnalisée et de propre du code. Un instance de chaque composant qui implémente l’interface IProcessInitializer sera créé et stocké pendant toute la durée du processus. Lorsqu’il est implémenté sur un ServicedComponent, le InitializesServerApplication paramètre dans la COMAdminCatalogObject collection Components doit être défini true sur pendant l’inscription du composant, afin que les méthodes d’interface soient appelées au démarrage et à l’arrêt.

À l’aide des Startup événements et Shutdown , vous pouvez initialiser des ressources, créer des connexions, initialiser des données partagées et exécuter du code de nettoyage. Toutefois, vous ne devez pas accéder aux états spécifiques à COM+, car les instances de composants serveur n’ont pas encore été créées. En outre, le code dans les Startup événements et Shutdown doit revenir aussi rapidement que possible, car le système n’attend que 90 secondes que Dllhost.exe se prépare à accepter les activations une fois que le système a démarré le processus. Si Dllhost.exe ne signale pas qu’il est prêt dans les 90 secondes, le système met fin au processus ; par conséquent, tous les traitements d’initialisation doivent être terminés dans ce laps de temps. Chaque composant serveur qui participe à l’initialisation doit prendre en charge l’interface IProcessInitializer . À DllHost.exe démarrage, COM+ crée tous les composants serveur qui ont demandé ce service, appelle QueryInterface l’interface IProcessInitializer et appelle la Startup fonction. De même, lorsque le processus DllHost.exe est arrêté, il appelle la Shutdown fonction sur les pointeurs d’interface précédemment stockés.

Méthodes

Shutdown()

Exécute des actions d’arrêt. Appelé lors de l’arrêt de Dllhost.exe.

Startup(Object)

Exécute l’initialisation au démarrage. Appelé lors du démarrage de Dllhost.exe.

S’applique à