Implementazione dell'interfaccia primaria per un provider di proprietà
Un provider di proprietà usa i metodi IWbemPropertyProvider come interfaccia primaria per WMI. Con IWbemPropertyProvider, è possibile implementare il codice per recuperare e modificare le proprietà della classe e dell'istanza.
Nella tabella seguente sono elencati i metodiIWbemPropertyProviderche è possibile implementare per un provider di proprietà.
Metodo | Caratteristica |
---|---|
GetProperty | Recupero |
InserisciProprietà | Modifica |
Nota
È necessario implementare un provider di proprietà come provider in-process. WMI inizializzerà i provider di proprietà scritti come servizi o file eseguibili, ma non chiamerà mai i loro metodi GetProperty e PutProperty.
Se si sceglie di non supportare uno di questi metodi, il provider può fornire un'implementazione stub che restituisce WBEM_E_PROVIDER_NOT_CAPABLE.
Un provider di proprietà identifica una classe o un'istanza gestita da un set di tre qualificatori: PropertyContext, InstanceContexte ClassContext. WMI passerà le costanti di stringa che descrivono questi tre qualificatori al provider di proprietà.
Il fornitore della proprietà deve essere preparato per gestire i tipi di qualificatori di contesto seguenti:
- Il qualificatore InstanceContext è associato a un'istanza e contiene informazioni applicabili a ogni proprietà nell'istanza di .
- Il qualificatore ClassContext è associato a una classe e contiene informazioni applicabili a ogni istanza della classe . Ad esempio, in una classe usata per archiviare i dati forniti dal provider del Registro di sistema, ClassContext può essere il percorso della chiave del Registro di sistema che contiene le proprietà da segnalare.
- Il qualificatore PropertyContext specifica le informazioni specifiche del contesto relative alla proprietà. Ad esempio, in una classe utilizzata per archiviare i dati forniti dal provider del Registro di sistema, PropertyContext specifica il nome del valore del Registro di sistema da archiviare dalla proprietà .
Questi qualificatori possono funzionare insieme. È possibile designare sia un valore InstanceContext che PropertyContext per indicare al provider come trattare determinati tipi di istanze. Ad esempio, è possibile contrassegnare le istanze che il provider riconoscerà come leggibile ma con una sola proprietà scrivibile.
Il qualificatore più comune usato è PropertyContext. Pertanto, WMI fornisce il qualificatore DynProps come scorciatoia. WMI considera che ogni proprietà in un'istanza contrassegnata con DynProps abbia anche i qualificatori Dynamic, Providere PropertyContext.