Interfaccia IWbemServices (wbemcli.h)

Articolo
08/27/2023

L'interfaccia IWbemServices viene usata dai client e dai provider per accedere ai servizi WMI. L'interfaccia viene implementata dai provider WMI e WMI ed è l'interfaccia WMI primaria.

    IWbemClassObject *pObj = NULL;

    // The pWbemSvc pointer is of type IWbemServices*
    // BSTR is not compatible with wchar_t, need to allocate.
    BSTR path = SysAllocString(L"path");
    pWbemSvc->GetObject(path, 0, 0, &pObj, 0);
    SysFreeString(path);

Ereditarietà

L'interfaccia IWbemServices eredita dall'interfaccia IUnknown . IWbemServices include anche questi tipi di membri:

Metodi

L'interfaccia IWbemServices dispone di questi metodi.


IWbemServices::CancelAsyncCall Il metodo IWbemServices::CancelAsyncCall annulla tutte le chiamate asincrone attualmente in sospeso in base al puntatore IWbemObjectSink, che è stato originariamente passato al metodo asincrono.
IWbemServices::CreateClassEnum Il metodo IWbemServices::CreateClassEnum restituisce un enumeratore per tutte le classi che soddisfano i criteri di selezione.
IWbemServices::CreateClassEnumAsync Il metodo IWbemServices::CreateClassEnumAsync restituisce un'enumerazione di tutte le classi supportate dal provider di classi.
IWbemServices::CreateInstanceEnum Il metodo IWbemServices::CreateInstanceEnum crea un enumeratore che restituisce le istanze di una classe specificata in base ai criteri di selezione specificati dall'utente.
IWbemServices::CreateInstanceEnumAsync Il metodo IWbemServices::CreateInstanceEnumAsync crea un enumeratore che restituisce in modo asincrono le istanze di una classe specificata in base ai criteri di selezione specificati dall'utente.
IWbemServices::D eleteClass Il metodo IWbemServices::D eleteClass elimina la classe specificata dallo spazio dei nomi corrente.
IWbemServices::D eleteClassAsync Il metodo IWbemServices::D eleteClassAsync elimina la classe specificata dallo spazio dei nomi corrente.
IWbemServices::D eleteInstance Il metodo IWbemServices::D eleteInstance elimina un'istanza di una classe esistente nello spazio dei nomi corrente.
IWbemServices::D eleteInstanceAsync Il metodo IWbemServices::D eleteInstanceAsync elimina in modo asincrono un'istanza di una classe esistente nello spazio dei nomi corrente. La conferma o l'errore dell'operazione viene segnalata tramite l'interfaccia IWbemObjectSink implementata dal chiamante.
IWbemServices::ExecMethod Esegue un metodo esportato da un oggetto CIM.
IWbemServices::ExecMethodAsync Esegue in modo asincrono un metodo esportato da un oggetto CIM.
IWbemServices::ExecNotificationQuery Il metodo IWbemServices::ExecNotificationQuery esegue una query per ricevere eventi. La chiamata restituisce immediatamente e l'utente può eseguire il polling dell'enumeratore restituito per gli eventi non appena arrivano. Il rilascio dell'enumeratore restituito annulla la query.
IWbemServices::ExecNotificationQueryAsync Il metodo IWbemServices::ExecNotificationQueryAsync esegue la stessa attività di IWbemServices::ExecNotificationQuery, ad eccezione del fatto che gli eventi vengono forniti al gestore di risposta specificato finché CancelAsyncCall non viene chiamato per arrestare la notifica dell'evento.
IWbemServices::ExecQuery Il metodo IWbemServices::ExecQuery esegue una query per recuperare gli oggetti.
IWbemServices::ExecQueryAsync Il metodo IWbemServices::ExecQueryAsync esegue una query per recuperare gli oggetti in modo asincrono.
IWbemServices::GetObject Il metodo IWbemServices::GetObject recupera una classe o un'istanza. Questo metodo recupera solo gli oggetti dallo spazio dei nomi associato all'oggetto IWbemServices corrente.
IWbemServices::GetObjectAsync Il metodo IWbemServices::GetObjectAsync recupera un oggetto, ovvero una definizione di classe o un'istanza, in base al relativo percorso.
IWbemServices::OpenNamespace Il metodo IWbemServices::OpenNamespace fornisce al chiamante un nuovo puntatore IWbemServices con lo spazio dei nomi figlio specificato come contesto operativo.
IWbemServices::P utClass Il metodo IWbemServices::P utClass crea una nuova classe o ne aggiorna uno esistente. La classe specificata dal parametro pObject deve essere stata inizializzata correttamente con tutti i valori di proprietà richiesti.
IWbemServices::P utClassAsync Il metodo IWbemServices::P utClassAsync crea una nuova classe o ne aggiorna uno esistente.
IWbemServices::P utInstance Il metodo IWbemServices::P utInstance crea o aggiorna un'istanza di una classe esistente. L'istanza viene scritta nel repository WMI.
IWbemServices::P utInstanceAsync Il metodo IWbemServices::P utInstanceAsync crea o aggiorna in modo asincrono un'istanza di una classe esistente. La conferma dell'aggiornamento o la segnalazione degli errori viene fornita tramite l'interfaccia IWbemObjectSink implementata dal chiamante.
IWbemServices::QueryObjectSink Il metodo IWbemServices::QueryObjectSink consente al chiamante di ottenere un gestore di notifica esportato da Gestione Windows.

Commenti

I provider che implementano l'interfaccia IWbemServices devono seguire la semantica documentata di ogni metodo implementato; e i provider devono supportare i codici restituiti di errore specificati. WMI implementa tutti i metodi e, in genere, ogni provider implementa un piccolo subset delle funzionalità disponibili nell'interfaccia. I provider devono restituire WBEM_E_PROVIDER_NOT_CAPABLE per qualsiasi metodo che non implementano.

Tutti i puntatori all'interfaccia in uscita da qualsiasi metodo IWbemServices devono essere inizializzati su NULL prima di chiamare il metodo di interfaccia. Ad esempio, le chiamate al metodo IWbemServices::GetObject restituiscono un puntatore all'interfaccia IWbemClassObject che deve essere pre-inizializzato su NULL prima della chiamata al metodo IWbemServices::GetObject .

Esempio

Per più esempi di C++ che usano IWbemServices, vedere la sezione Esempi di applicazioni C++ WMI .

Nell'esempio di codice seguente viene illustrato come un provider può ottenere un puntatore IWbemServices . Il codice richiede le istruzioni e i riferimenti #include seguenti per la compilazione.

#include <iostream>
using namespace std;
#include <wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")

IWbemLocator *pIWbemLocator = NULL;

HRESULT hRes = CoCreateInstance (
            CLSID_WbemAdministrativeLocator,
            NULL ,
            CLSCTX_INPROC_SERVER | CLSCTX_LOCAL_SERVER , 
            IID_IUnknown ,
            ( void ** ) &pIWbemLocator
            ) ;

IWbemServices *pWbemServices = NULL;

if (SUCCEEDED(hRes))
{
    BSTR namespace = SysAllocString(L"root\\CIMV2");
    hRes = pIWbemLocator->ConnectServer(
                namespace,      // Namespace
                NULL,           // Userid
                NULL,           // PW
                NULL,           // Locale
                0,              // flags
                NULL,           // Authority
                NULL,           // Context
                &pWbemServices
                );
    SysFreeString(namespace);            

    pIWbemLocator->Release(); // Free memory resources.

    // Use pWbemServices

}

// Clean up
pWbemServices->Release();

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)

Vedi anche

API COM per WMI

Creazione di provider WMI

Modifica delle informazioni sulle classi e sulle istanze

Specifica dei dati a WMI scrivendo un provider