Metodo IWbemConfigureRefresher::AddEnum (wbemcli.h)

Articolo
03/03/2024

Il metodo IWbemConfigureRefresher::AddEnum aggiunge un enumeratore al servizio di aggiornamento richiesto.

Sintassi

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

Parametri

[in] pNamespace

Puntatore IWbemServices in Gestione Windows, che può gestire qualsiasi richiesta effettuata dal provider. Se il metodo deve tornare in Gestione Windows durante l'esecuzione, il provider deve chiamare AddRef con il puntatore pNamespace .

[in] wszClassName

Stringa con terminazione null di caratteri Unicode a 16 bit contenente il nome della classe enumerata.

[in] lFlags

Maschera di flag che modificano il comportamento di questo metodo. Se questo parametro è impostato su WBEM_FLAG_USE_AMENDED_QUALIFIERS, le istanze restituite contengono qualificatori localizzati se disponibili.

[in] pContext

In genere NULL; in caso contrario, si tratta di 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] ppEnum

Puntatore che contiene il riferimento a un oggetto IWbemHiPerfEnum , che conterrà l'enumerazione. Il client deve chiamare Release su questo puntatore quando non è più necessario.

[out] plId

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

NotaHRESULT

Commenti

La classe fornita deve specificare una classe valida, fornita dal provider di High-Performance. Tutte le istanze dell'enumeratore restituito possono essere sottoposte a query dopo le chiamate. In ogni chiamata per aggiornare il numero di istanze nell'enumeratore può variare. Vengono restituite solo istanze del nome della classe specificata; Le sottoclassi della classe specificata non verranno enumerate perché l'enumerazione dettagliata non è supportata. L'enumeratore restituito non deve essere toccato dal client mentre è in corso un'operazione di aggiornamento . L'identificatore restituito può essere usato dalla funzione Remove per rimuovere l'oggetto. Si noti che non è necessario per l'utente rimuovere in modo esplicito gli enumeratori aggiunti. Tuttavia, il client deve chiamare Release nell'enumeratore 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

IWbemConfigureRefresher

Condividi tramite