Metodo IWbemConfigureRefresher::AddObjectByTemplate (wbemcli.h)

Con il metodo IWbemConfigureRefresher::AddObjectByTemplate , è possibile aggiungere un oggetto da aggiornare a un refresher specificando un modello di istanza IWbemClassObject . Utilizzare questo metodo quando è difficile costruire un percorso oggetto per un oggetto da aggiungere a un aggiornamento.

Sintassi

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parametri

pNamespace

Puntatore IWbemServices in Gestione Windows, che può gestire qualsiasi richiesta effettuata dal provider. Il provider deve chiamare AddRef su questo puntatore se verrà richiamato in Gestione Windows durante l'esecuzione.

[in] pTemplate

Puntatore a un oggetto IWbemClassObject che contiene il modello di istanza.

[in] lFlags

Maschera di bit di flag che modificano il comportamento di questo metodo. Se questo parametro è impostato su WBEM_FLAG_USE_AMENDED_QUALIFIERS, l'istanza restituita conterrà qualificatori localizzati, se disponibili.

[in] pContext

In genere NULL; in caso contrario, un puntatore a un oggetto IWbemContext richiesto da uno o più provider di classi dinamiche. I valori nell'oggetto contesto devono essere specificati nella documentazione specifica del provider. Per altre informazioni su questo parametro, vedere Effettuare chiamate a WMI.

[out] ppRefreshable

Puntatore per contenere il riferimento a un oggetto IWbemClassObject , che conterrà l'oggetto istanza aggiornabile. Il client deve chiamare Release sull'oggetto restituito quando non è più necessario.

[out] plId

Puntatore a un numero intero restituito dal provider che identifica in modo univoco questo oggetto aggiornabile.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in hrESULT.

Commenti

L'istanza fornita deve specificare un oggetto valido, fornito dal provider di High-Performance. L'oggetto restituito non deve essere modificato dal client mentre è in corso un'operazione di aggiornamento. L'identificatore restituito può essere utilizzato dalla funzione Remove per rimuovere l'oggetto.

Non è necessario che l'utente rimuova esplicitamente gli oggetti aggiunti. Il client deve chiamare Release sull'oggetto restituito quando non è più necessario.

Requisiti

Vedi anche

Accesso ai dati sulle prestazioni in C++

IWbemConfigureRefresher

Creazione di un provider di istanze in un provider di High-Performance

Provider contatore prestazioni