Classe provider (provider.h)
[La classe Provider fa parte di WMI Provider Framework, che viene ora considerata in stato finale e non saranno disponibili ulteriori sviluppi, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.
La classe Provider è la classe base per la classe o le classi supportate dal provider di framework. La classe Provider incapsula le implementazioni dei metodi di IWbemServices e include diverse funzioni helper. Un provider di framework esegue l'override di uno dei metodi della classe Provider per ogni funzionalità supportata. Ad esempio, un provider che supporta l'elaborazione di query esegue l'override del metodo Provider::ExecQuery .
Viene creata un'istanza della classe Provider per ogni classe WMI con un provider di framework.
Il provider ha questi tipi di membri:
| Metodo | Descrizione |
|---|---|
| Eseguire il commit | Restituisce l'istanza corrente a WMI. |
| CreateNewInstance | Alloca un nuovo oggetto CInstance e restituisce un puntatore. |
| DeleteInstance | Elimina un'istanza di . Chiamato da WMI. |
| EnumerateInstances | Recupera tutte le istanze della classe di un provider di framework. Chiamato da WMI. |
| ExecMethod | Richiama un metodo su una classe o un'istanza di . Chiamato da WMI. |
| ExecQuery | Elabora una query WQL (WMI Query Language). Chiamato da WMI. |
| Svuotamento | Chiamato dal framework del provider per eliminare tutta la memoria non necessaria in uso dal provider. |
| GetLocalComputerName | Restituisce un riferimento costante al nome del computer in formato CHString . |
| GetLocalInstancePath | Tenta di compilare un percorso completo dell'oggetto a un'istanza specificata. |
| Getobject | Recupera un'istanza di una classe . Chiamato da WMI. |
| GetProviderName | Recupera il nome del provider. |
| MakeLocalPath | Compila un percorso di istanza completo da un percorso relativo. |
| Putinstance | Aggiornamenti un'istanza di . Chiamato da WMI. |
| SetCreationClassName | Imposta la proprietà stringa CreationClassName dell'istanza specificata sul nome del provider. |
| ValidateDeletionFlags | Determina se un set di flag è valido per un'operazione di eliminazione. |
| ValidateEnumerationFlags | Determina se un set di flag è valido per un'enumerazione. |
| ValidateFlags | Determina se un set di flag è valido. |
| ValidateGetObjFlags | Determina se un set di flag è valido per un'operazione di recupero dell'istanza. |
| ValidateMethodFlags | Determina se un set di flag è valido per un'operazione di esecuzione del metodo. |
| ValidatePutInstanceFlags | Determina se un set di flag è valido per un'operazione di aggiornamento dell'istanza. |
| ValidateQueryFlags | Determina se un set di flag è valido per un'operazione di query. |
Ereditarietà
La classe Provider implementa CThreadBase.
Metodi
La classe Provider dispone di questi metodi.
| Provider::~Provider La funzione Provider::~Provider è un distruttore per la classe Provider. |
| Provider::Commit Il metodo Commit viene usato per inviare un'istanza a WMI. Questo metodo è una funzione helper e non deve essere sottoposto a override. |
| Provider::CreateNewInstance Il metodo CreateNewInstance alloca un nuovo oggetto CInstance e ne restituisce un puntatore. |
| Provider::D eleteInstance Il metodo DeleteInstance viene chiamato da WMI per eliminare un'istanza di . (overload 2/2) |
| Provider::D eleteInstance Il metodo DeleteInstance viene chiamato da WMI per eliminare un'istanza di . (overload 1/2) |
| Provider::EnumerateInstances Il metodo EnumerateInstances viene chiamato da WMI per recuperare tutte le istanze della classe di un provider di framework. |
| Provider::ExecMethod Il metodo ExecMethod viene chiamato da WMI per richiamare un metodo su una classe o un'istanza. (overload 1/2) |
| Provider::ExecMethod Il metodo ExecMethod viene chiamato da WMI per richiamare un metodo su una classe o un'istanza. (overload 2/2) |
| Provider::ExecQuery Il metodo ExecQuery viene chiamato da WMI per elaborare una query WQL (WMI Query Language). |
| Provider::Flush Il metodo Flush viene chiamato dal framework del provider per eliminare tutta la memoria non necessaria in uso dal provider. |
| Provider::GetLocalComputerName Il metodo GetLocalComputerName restituisce un riferimento costante al nome del computer in formato CHString. |
| Provider::GetLocalInstancePath Il metodo GetLocalInstancePath tenta di compilare un percorso completo dell'oggetto a un'istanza specificata. Questo metodo è una funzione helper e non deve essere sottoposto a override. |
| Provider::GetNamespace Il metodo GetNamespace restituisce un riferimento costante al nome dello spazio dei nomi in formato CHString. Il nome restituito è il secondo parametro originariamente assegnato al costruttore del provider. |
| Provider::GetObject Il metodo GetObject viene chiamato da WMI per recuperare un'istanza di una classe. (overload 1/3) |
| Provider::GetObject Il metodo GetObject viene chiamato da WMI per recuperare un'istanza di una classe. (overload 2/3) |
| Provider::GetObject Il metodo GetObject viene chiamato da WMI per recuperare un'istanza di una classe. (overload 3/3) |
| Provider::GetProviderName Il metodo GetProviderName recupera il nome della classe utilizzata nel costruttore del provider. |
| Provider::MakeLocalPath Il metodo MakeLocalPath compila un percorso di istanza completo da un percorso relativo. |
| Provider::P rovider Il metodo Provider crea un'istanza di un provider. Questo metodo fa parte di WMI Provider Framework. |
| Provider::P utInstance Il metodo PutInstance aggiorna un'istanza di . (overload 2/2) |
| Provider::P utInstance Il metodo PutInstance aggiorna un'istanza di . (overload 1/2) |
| Provider::SetCreationClassName Il metodo SetCreationClassName imposta la proprietà stringa CreationClassName, se presente, dell'istanza specificata sul nome del provider. |
| Provider::ValidateDeletionFlags Il metodo ValidateDeletionFlags determina se un set di flag è valido per un'operazione di eliminazione. |
| Provider::ValidateEnumerationFlags Il metodo ValidateEnumerationFlags determina se un set di flag è valido per un'enumerazione. |
| Provider::ValidateFlags Il metodo ValidateFlags determina se un set di flag è valido. |
| Provider::ValidateGetObjFlags Il metodo ValidateGetObjFlags determina se un set di flag è valido per un'operazione di recupero dell'istanza. |
| Provider::ValidateMethodFlags Il metodo ValidateMethodFlags determina se un set di flag è valido per un'operazione del metodo execute. |
| Provider::ValidatePutInstanceFlags Il metodo ValidatePutInstanceFlags determina se un set di flag è valido per un'operazione di aggiornamento dell'istanza. |
| Provider::ValidateQueryFlags Il metodo ValidateQueryFlags determina se un set di flag è valido per un'operazione di query. |
Commenti
Il distruttore per questa classe è Provider::~Provider.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | provider.h (include FwCommon.h) |