Description récapitulative des classes COMAdmin
Il existe trois classes fournies par la bibliothèque COMAdmin (comadmin.dll), chacune implémentant une double interface COM. Vous utilisez des objets créés à partir de ces classes pour accéder au catalogue, représenter des collections dans le catalogue et représenter les éléments contenus dans les collections.
COMAdminCatalog
La classe COMAdminCatalog représente le catalogue lui-même. Un objet créé à partir de COMAdminCatalog est l’objet fondamental que vous utilisez dans l’administration par programme. En plus d’établir la connexion de base avec le serveur de catalogue lorsque vous l’instanciez, COMAdminCatalog fournit des méthodes qui vous permettent d’effectuer les opérations suivantes :
- Obtenir des collections sur le catalogue.
- Connectez-vous au serveur de catalogue sur un ordinateur distant.
- Installez, exportez, démarrez, arrêtez et obtenez des informations sur les applications COM+.
- Installez des composants dans des applications COM+ et obtenez des informations sur les composants.
- Démarrez, arrêtez ou actualisez les services en cours d’exécution sur l’ordinateur.
- Actualisez, restaurez ou sauvegardez les informations du catalogue.
Dans COM+ 1.0, la classe COMAdminCatalog implémente l’interface ICOMAdminCatalog . Dans COM+ 1.5, la classe COMAdminCatalog implémente ICOMAdminCatalog2 comme interface par défaut.
COMAdminCatalogCollection
La classe COMAdminCatalogCollection représente n’importe quelle collection dans le catalogue, en fournissant une chaîne nommant la collection particulière au moment de l’instanciation de l’objet. (Les collections de catalogue disponibles sont nommées dans le tableau dans COLLECTIONS d’administration COM+.) Des objets sont créés à partir de cette classe lors de la récupération d’une collection de niveau supérieur en appelant la méthode GetCollection de l’objet COMAdminCatalog . Ces objets sont également créés lors de la récupération d’une collection enfant en appelant la méthode GetCollection de son objet de collection parent. Les objets COMAdminCatalogCollection vous permettent d’effectuer les opérations suivantes :
- Énumérez les éléments contenus dans la collection.
- Récupérer un élément de la collection.
- Ajouter ou supprimer des éléments dans ou à partir de la collection.
- Enregistrez ou ignorez les modifications en attente apportées à la collection ou aux éléments qu’elle contient.
- Obtenez une autre collection dans le catalogue.
La classe COMAdminCatalogObject implémente l’interface ICatalogCollection .
COMAdminCatalogObject
La classe COMAdminCatalogObject représente tout élément contenu dans une collection. Des objets sont créés à partir de cette classe lors de l’obtention d’un élément via la propriété Item d’un objet de collection de catalogue. Les objets créés à partir de la classe COMAdminCatalogObject vous permettent d’effectuer les opérations suivantes :
- Obtenez ou définissez les propriétés prises en charge par l’élément que l’objet est utilisé pour représenter.
- Obtenir des informations sur l’élément et ses propriétés.
La classe COMAdminCatalogObject implémente l’interface ICatalogObject .
Rubriques connexes