Metodo IWbemConfigureRefresher::AddObjectByPath (wbemcli.h)

  • Articolo

Il metodo IWbemConfigureRefresher::AddObjectByPath aggiunge un oggetto a un aggiornamento specificando un percorso oggetto.

Sintassi

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parametri

[in] 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] wszPath

Costante, stringa con terminazione null di caratteri Unicode a 16 bit che contiene il percorso dell'oggetto aggiunto al aggiornatore.

[in] lFlags

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

[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 Creazione di chiamate a WMI.

[out] ppRefreshable

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

[out] plId

Puntatore a un intero restituito dal provider che identifica in modo univoco l'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 un HRESULT.

Commenti

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

Nota Non è necessario per l'utente rimuovere in modo esplicito gli oggetti aggiunti. Il client deve chiamare Release sull'oggetto restituito quando non è più necessario.
 

Requisiti

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

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