API COM per WMI

  • Articolo

È possibile usare l'API COM (Component Object Model) WMI per scrivere applicazioni client di gestione o creare un nuovo provider WMI. Le informazioni di riferimento sull'API COM forniscono informazioni per gli amministratori di sistema avanzati, nonché per gli sviluppatori che scrivono applicazioni client e provider.

Per altre informazioni sulla scrittura di applicazioni di gestione aziendale WMI, vedere Creazione di un'applicazione WMI con C++. Per altre informazioni su come scrivere un provider WMI, vedere Fornire dati a WMI.

Nota

WMI supporta solo lo sviluppo C++ con Microsoft Visual C++ versione 6.0 e sistemi di sviluppo successivi. Tuttavia, è anche possibile usare altri compilatori, ad esempio quelli di Borland e Watcom.

 

Ognuno dei diversi oggetti WMI eredita da un'interfaccia ereditata dall'interfaccia IUnknown . COM determina il modo in cui gli implementatori di oggetti o le interfacce gestiscono attività come gestione della memoria, gestione dei parametri e multithreading. Conforme a COM, l'API COM per WMI garantisce che supporti le funzionalità fornite dalle interfacce di ogni oggetto WMI.

È possibile accedere a WMI tramite le interfacce COM specifiche di WMI seguenti.

Interfaccia Descrizione
IEnumWbemClassObject Enumeratore che funziona con oggetti di tipo IWbemClassObject. È simile agli enumeratori COM standard, ad esempio IEnumVariant.
IMofCompiler Implementata da Mofd.dll, questa interfaccia fornisce un'interfaccia COM usata dal compilatore MOF e da qualsiasi altra applicazione che compila file MOF.
IUnsecuredApartment Usato per semplificare il processo di esecuzione di chiamate asincrone da un processo client.
IWbemBackupRestore Esegue il backup e ripristina il contenuto del repository WMI.
IWbemCallResult Usato per le chiamate semisynchronous dell'interfaccia IWbemServices . Quando si effettuano tali chiamate, il metodo IWbemServices restituisce immediatamente, insieme a un oggetto IWbemCallResult .
IWbemCausalityAnalysis Tiene traccia delle richieste figlio generate da una richiesta padre.
IWbemClassObject Contiene e modifica sia le definizioni di classe che le istanze dell'oggetto classe. Gli sviluppatori non devono implementare questa interfaccia; WMI fornisce la relativa implementazione.
IWbemConfigureRefresher Usato dal codice client per aggiungere o rimuovere enumeratori, oggetti e aggiornamenti annidati in un aggiornamento.
IWbemContext Facoltativamente usato per comunicare informazioni di contesto aggiuntive ai provider durante l'invio di chiamate IWbemServices a Gestione Windows.
IWbemDecoupledBasicEventProvider Registra provider disaccoppiati con WMI.
IWbemDecoupledRegistrar Associa provider disaccoppiati a WMI. Questa interfaccia consente a un provider ospitato dal processo di definire la durata di interoperabilità dell'interfaccia e coesistere con altri provider.
IWbemEventConsumerProvider Fornisce l'interfaccia primaria per un provider di consumer di eventi. Tramite questa interfaccia e il metodo FindConsumer , un provider di consumer di eventi può indicare quali consumer di eventi devono ricevere un determinato evento.
IWbemEventProvider Usato per avviare la comunicazione con un provider di eventi.
IWbemEventProviderQuerySink Facoltativamente implementata dai provider di eventi che vogliono sapere quali tipi di filtri di query di eventi sono attualmente attivi per ottimizzare le prestazioni.
IWbemEventProviderSecurity Facoltativamente implementata dai provider di eventi che vogliono limitare l'accesso degli utenti al proprio evento.
IWbemEventSink Avvia la comunicazione con un provider di eventi usando un set limitato di query. Questa interfaccia estende IWbemObjectSink, fornendo nuovi metodi che gestiscono sicurezza e prestazioni.
IWbemHiPerfProvider Consente ai provider di fornire oggetti e enumeratori aggiornabili.
IWbemHiPerfEnum Usato nelle operazioni di aggiornamento per fornire accesso rapido alle enumerazioni degli oggetti istanza.
IWbemLocator Ottiene il puntatore dello spazio dei nomi iniziale all'interfaccia IWbemServices per WMI in un computer host specifico.
IWbemObjectAccess Fornisce l'accesso ai metodi e alle proprietà di un oggetto . Un oggetto IWbemObjectAccess è un contenitore per un'istanza aggiornata da un refresher.
IWbemObjectSink Usato per ricevere sia i risultati di IWbemServices che determinati tipi di notifiche degli eventi.
IWbemObjectTextSrc Usato per tradurre le istanze di IWbemClassObject in e da formati di testo diversi.
IWbemPropertyProvider Supporta il recupero e l'aggiornamento di singole proprietà in un'istanza di una classe WMI.
IWbemProviderIdentity Implementato da un provider di eventi se il provider si registra usando più di un nome (più istanze di __Win32Provider) con lo stesso valore CLSID . La classe fornisce un meccanismo per distinguere il provider denominato da usare.
IWbemProviderInit Utilizzato per inizializzare i provider.
IWbemProviderInitSink Implementato da WMI e chiamato dai provider per segnalare lo stato di inizializzazione.
IWbemQualifierSet Funge da contenitore per l'intero set di qualificatori denominati per una singola proprietà o un intero oggetto (una classe o un'istanza).
IWbemQuery Fornisce un punto di ingresso tramite il quale è possibile analizzare una query WQL ( WMI Query Language ).
IWbemRefresher Fornisce un punto di ingresso tramite il quale è possibile aggiornare oggetti aggiornabili, ad esempio enumeratori o oggetti di aggiornamento.
Iwbemservices Usato da client e provider per accedere ai servizi WMI. L'interfaccia viene implementata solo da WMI ed è l'interfaccia WMI primaria.
IWbemStatusCodeText Estrae le descrizioni delle stringhe di testo dei codici di errore o il nome del sottosistema in cui si è verificato l'errore.
IWbemUnboundObjectSink Implementato da tutti i consumer di eventi logici. Si tratta di un'interfaccia sink semplice che accetta il recapito di oggetti evento.

 

Nota

Molte delle funzioni COM WMI restituiscono codici di errore numerici documentati come costanti denominate. Queste costanti sono definite in Wbemcli.h nella cartella WMI\Include PSDK. Per altre informazioni, vedere Codici restituiti WMI.

 

Per altre informazioni sugli argomenti seguenti per la programmazione COM, vedere Sviluppo di componenti:

  • Interfacce e progettazione di oggetti.
  • Implementazione di IUnknown.
  • Gestione della memoria
  • Gestione del conteggio dei riferimenti.

Informazioni di riferimento SU WMI