Condividi tramite


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.