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.

Diagram that shows the relationships among the collections.

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.