Gestione degli errori di Amministrazione istration COM+

Gli errori generati quando si utilizzano gli oggetti COM Amministrazione vengono segnalati in due modi, come indicato di seguito:

  • Utilizzo di codici di errore specifici della libreria COM Amministrazione.
  • Uso delle informazioni estese sugli errori disponibili in una raccolta ErrorInfo speciale.

Codici di errore

I codici di errore di amministrazione vengono gestiti come qualsiasi messaggio di errore COM. In Microsoft Visual C++, questi codici vengono restituiti come valori HRESULT . In Microsoft Visual Basic, vengono generate come eccezioni che è possibile intercettare. Per i programmatori C++, i codici di errore di amministrazione COM+ sono definiti in Winerror.h. Per i programmatori di Visual Basic, sono disponibili tramite l'IDE di Visual Basic.

Raccolta ErrorInfo

Quando si verifica un errore, segnalato da un tipo di codice di errore, potrebbero essere disponibili informazioni più dettagliate, a seconda della natura dell'errore. Gli oggetti COM Amministrazione forniscono informazioni estese in circostanze in cui la causa precisa dell'errore è difficile da determinare senza un report dettagliato, ad esempio con più operazioni di lettura e scrittura.

Ad esempio, quando si utilizzano metodi come Populate e SaveChanges in un oggetto COM Amministrazione CatalogCollection, è possibile leggere o scrivere dati per ogni elemento dell'insieme. Possono verificarsi errori complessi e possono essere difficili da diagnosticare in base a un singolo codice di errore numerico. Pertanto, la libreria COM Amministrazione rende estese le informazioni sugli errori tramite una raccolta speciale.

Quando sono disponibili informazioni di errore estese, vengono inserite nell'insieme ErrorInfo correlato alla raccolta originale che ha generato l'errore. Per recuperare il report degli errori, ottenere l'insieme ErrorInfo correlato alla raccolta originale ed esaminare gli elementi contenuti. È possibile recuperare l'insieme ErrorInfo usando GetCollection in COM Amministrazione CatalogCollection, lasciando vuoto il secondo parametro in cui in genere si specifica la proprietà Key di un elemento padre.

Quando viene visualizzato un errore, è necessario ottenere e popolare immediatamente la raccolta ErrorInfo per la raccolta che non è riuscita, senza eseguire altre operazioni su tale raccolta. In caso contrario, la raccolta ErrorInfo viene reimpostata e non descrive in dettaglio l'errore.

Gli elementi dell'insieme ErrorInfo espongono le proprietà speciali di segnalazione errori MajorRef e MinorRef, che descrivono in dettaglio la causa specifica dell'errore. Per altre informazioni, vedere ErrorInfo.

Operazioni di Amministrazione istration COM+ all'interno delle transazioni

Esempio introduttivo relativo all'uso del catalogo di Amministrazione istration COM+

Panoramica degli oggetti COM Amministrazione

Recupero di raccolte nel catalogo COM+

Impostazione delle proprietà e salvataggio delle modifiche nel catalogo COM+