Raccolte di amministrazione COM+
Le raccolte di amministrazione COM+ consentono di contenere e organizzare i dati di configurazione archiviati nel catalogo COM+. Le raccolte corrispondono alle cartelle nell'albero della console dello strumento di amministrazione di Servizi componenti. È possibile accedere a queste raccolte usando gli oggetti e le interfacce di amministrazione COM+.
Per avviare l'amministrazione a livello di codice, utilizzare gli oggetti creati dalla classe COMAdminCatalog , è possibile rappresentare tutte le raccolte nel catalogo usando oggetti creati dalla classe COMAdminCatalogCollection e rappresentare gli elementi nelle raccolte utilizzando oggetti creati dalla classe COMAdminCatalogObject .
Gli elementi in una determinata raccolta espongono un set coerente di proprietà. Ad esempio, ogni elemento dell'insieme Components rappresenta un componente e gli elementi dell'insieme Components espongono le stesse proprietà usate per configurare un componente. È possibile accedere a queste proprietà usando la classe COMAdminCatalogObject .
Nota
Le proprietà con accesso WriteOnce sono ReadWrite durante l'uso del metodo Add prima di usare SaveChanges e sono ReadOnly in seguito.
Per un'introduzione all'amministrazione programmatica di COM+, vedere Automazione dell'amministrazione COM+.
Gerarchia raccolta
Nella figura seguente vengono illustrate le relazioni tra le raccolte. Le raccolte all'estrema sinistra (in caselle bianche e grigie) sono raccolte di primo livello a cui si accede chiamando il metodo GetCollection di un oggetto creato dalla classe COMAdminCatalog . È possibile accedere alle raccolte rimanenti (in caselle gialle) solo tramite la raccolta padre, chiamando il metodo GetCollection dell'oggetto COMAdminCatalogCollection che rappresenta il relativo padre. Le frecce puntano da una raccolta padre alle raccolte figlio.
Le quattro raccolte seguenti non sono illustrate nella figura: ErrorInfo, PropertyInfo, RelatedCollectionInfo e Root. L'insieme ErrorInfo è un elemento figlio di ogni raccolta nella figura, ad eccezione di InprocServers e WOWInprocServers (in caselle grigie). Gli insiemi PropertyInfo e RelatedCollectionInfo sono elementi figlio di ogni raccolta. La raccolta Root è una raccolta di primo livello padre di tutte le altre raccolte di primo livello. Tuttavia, non è necessario accedere alla raccolta Radice prima di accedere ad altre raccolte di primo livello.
Libreria COMAdmin
Le raccolte seguenti sono supportate dalla libreria COMAdmin.
Raccolta | Descrizione |
---|---|
ApplicationCluster | Contiene un elenco dei server nel cluster di applicazioni. |
ApplicationInstances | Contiene un oggetto per ogni istanza di un'applicazione COM+ in esecuzione. |
Applicazioni | Contiene un oggetto per ogni applicazione COM+ installata nel computer locale. |
Componenti | Contiene un oggetto per ogni componente nell'applicazione a cui è correlato. |
ComputerList | Contiene un elenco dei computer disponibili nella cartella Computer dello strumento di amministrazione di Servizi componenti. |
DCOMProtocols | Contiene un elenco dei protocolli da usare da DCOM. Contiene un oggetto per ogni protocollo. |
Errorinfo | Recupera informazioni di errore estese relative ai metodi che gestiscono più oggetti. |
EventClassesForIID | Recupera informazioni relative alle classi di evento. |
FilesForImport | Recupera informazioni dal relativo file MSI su un'applicazione che può essere importata. |
InprocServers | Contiene un elenco dei server in-process registrati nel sistema. Contiene un oggetto per ogni componente. |
InterfacceForComponent | Contiene un oggetto per ogni interfaccia esposta dal componente a cui è correlata la raccolta. |
LegacyComponents | Contiene un oggetto per ogni componente non configurato nell'applicazione a cui è correlato. |
LegacyServers | Identico all'insieme InprocServers , ad eccezione del fatto che questa raccolta include anche i server locali. |
LocalComputer | Contiene un singolo oggetto che contiene informazioni sulle impostazioni a livello di computer per il computer a cui si accede al catalogo. |
MethodsForInterface | Contiene un oggetto per ogni metodo nell'interfaccia a cui è correlata la raccolta. |
Partizioni | Consente di specificare le applicazioni contenute in ogni partizione. |
PartitionUsers | Usato per specificare gli utenti contenuti in ogni partizione. |
Propertyinfo | Recupera informazioni sulle proprietà supportate da una raccolta specificata. |
PublisherProperties | Contiene un oggetto per ogni proprietà del server di pubblicazione per l'insieme Parent SubscriptionsForComponent . |
RelatedCollectionInfo | Recupera informazioni su altre raccolte correlate alla raccolta da cui viene chiamata. |
Ruoli | Contiene un oggetto per ogni ruolo assegnato all'applicazione a cui è correlata. |
RolesForComponent | Contiene un oggetto per ogni ruolo assegnato al componente a cui è correlata la raccolta. |
RolesForInterface | Contiene un oggetto per ogni ruolo assegnato all'interfaccia a cui è correlata la raccolta. |
RolesForMethod | Contiene un oggetto per ogni ruolo assegnato al metodo a cui è correlata la raccolta. |
RolesForPartition | Contiene un oggetto per ogni ruolo assegnato alla partizione a cui è correlata la raccolta. |
Radice | Contiene le raccolte di primo livello nel catalogo. |
SubscriberProperties | Contiene un oggetto per ogni proprietà del sottoscrittore per l'insieme Parent SubscriptionsForComponent . |
SubscriptionsForComponent | Contiene un oggetto per ogni sottoscrizione per l'insieme Components padre. |
TransientPublisherProperties | Contiene un oggetto per ogni proprietà del server di pubblicazione per l'insieme TransientSubscriptions padre. |
TransientSubscriberProperties | Contiene un oggetto per ogni proprietà del sottoscrittore per l'insieme TransientSubscriptions padre. |
Sottoscrizioni temporanee | Contiene un oggetto per ogni sottoscrizione temporanea. |
UsersInPartitionRole | Contiene un oggetto per ogni utente nel ruolo di partizione a cui è correlata la raccolta. |
UsersInRole | Contiene un oggetto per ogni utente nel ruolo a cui è correlata la raccolta. |
WOWInprocServers | Contiene un elenco dei server in-process registrati nel sistema per i componenti a 32 bit nei computer a 64 bit. |
WOWLegacyServers | Identico all'insieme LegacyServers , ad eccezione del fatto che questa raccolta viene disegnata dal Registro di sistema a 32 bit nei computer a 64 bit. |