IProcessInitializer Interface

Définition

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é

System.ServiceModel.ComIntegration.DllHostInitializer

Attributs

GuidAttribute InterfaceTypeAttribute

Remarques

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

COM+ fournit Startup et Shutdown événements lorsque Dllhost.exe démarre et se termine. Cette fonctionnalité permet à tous les composants COM+ installés dans une application serveur COM+ (appelées composants de serveur ci-après) d’exécuter l’initialisation personnalisée et de nettoyer le code. Une instance de chaque composant qui implémente l’interface IProcessInitializer sera créée et stockée pendant la durée du processus. En cas d’implémentation 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 événements et Startup des Shutdown ressources, vous pouvez initialiser des ressources, créer des connexions, initialiser des données partagées et exécuter le code de nettoyage. Toutefois, vous ne devez pas accéder aux états spécifiques à COM+, car les instances des composants serveur n’ont pas encore été créées. En outre, le code dans les événements et Startup les Shutdown événements doit retourner le plus rapidement possible, car le système attend seulement 90 secondes pour Dllhost.exe de préparer l’acceptation des activations après le démarrage du système. Si Dllhost.exe ne signale pas qu’il est prêt dans les 90 secondes, le système met fin au processus ; ainsi, tout le traitement d’initialisation doit être effectué dans ce délai. Chaque composant serveur qui participe à l’initialisation doit prendre en charge l’interface IProcessInitializer . Au démarrage de DllHost.exe, COM+ crée tous les composants serveur qui ont demandé ce service, appellent QueryInterface l’interface IProcessInitializer et appellent la Startup fonction. De même, lorsque le processus DllHost.exe est arrêté, il appelle la Shutdown fonction sur ces pointeurs d’interface précédemment stockés.