Metodo IWbemClassObject::Next (wbemcli.h)

Articolo
08/27/2023

Il metodo IWbemClassObject::Next recupera la proprietà successiva in un'enumerazione avviata con IWbemClassObject::BeginEnumeration. Questa operazione deve essere chiamata ripetutamente per enumerare tutte le proprietà fino a quando non WBEM_S_NO_MORE_DATA restituisce . Se l'enumerazione deve essere terminata in anticipo, è necessario chiamare IWbemClassObject::EndEnumeration .

L'ordine delle proprietà restituite durante l'enumerazione non è definito.

Sintassi

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

Parametri

[in] lFlags

Riservato. Questo parametro deve essere 0.

[out] strName

Riceve un nuovo BSTR che contiene il nome della proprietà. Per evitare perdite di memoria nel processo client, il chiamante deve chiamare SysFreeString quando il nome non è più necessario. È possibile impostare questo parametro su NULL se il nome non è obbligatorio.

[out] pVal

Questo valore VARIANT viene riempito con il valore della proprietà . Il metodo chiama VariantInit su questo VARIANT, quindi il chiamante deve assicurarsi che VARIANT non sia attivo prima della chiamata. Il chiamante deve usare VariantClear quando il valore non è più necessario.

È possibile impostare questo parametro su NULL se il valore non è obbligatorio. Se viene restituito un codice di errore , la variante a cui punta pVal viene lasciata invariata.

[out, optional] pType

Questo parametro può essere NULL. Se non è NULL, deve puntare a una variabile CIMTYPE(long) in cui viene inserito il tipo della proprietà. È possibile che il valore di questa proprietà possa essere un VT_NULLVARIANT, nel qual caso è necessario determinare il tipo effettivo della proprietà.

[out, optional] plFlavor

Può essere NULL. Se non è NULL, il valore LONG a cui punta riceve informazioni sull'origine della proprietà come indicato di seguito. Per altre informazioni, vedere Tipi di qualificatore e WBEM_FLAVOR_TYPE.

WBEM_FLAVOR_ORIGIN_SYSTEM

La proprietà è una proprietà di sistema standard.

Per le classi:

WBEM_FLAVOR_ORIGIN_PROPAGATED

La proprietà è stata ereditata dalla classe padre.

La proprietà, ereditata dalla classe padre, non è stata modificata a livello di istanza.

WBEM_FLAVOR_ORIGIN_LOCAL

La proprietà appartiene alla classe più derivata.

La proprietà viene modificata a livello di istanza, ovvero è stato fornito un valore o un qualificatore è stato aggiunto/modificato.

Per le istanze:

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. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Commenti

Se il tipo sottostante della proprietà è un percorso oggetto, una data o un'ora o un altro tipo speciale, il tipo restituito non contiene informazioni sufficienti. Il chiamante deve esaminare CIMTYPE per la proprietà specificata e determinare se la proprietà è un riferimento all'oggetto, una data o un'ora o un altro tipo speciale.

Questo metodo restituisce anche le proprietà di sistema.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)
Libreria	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll