Funzione Next

Articolo
05/10/2023

Recupera la proprietà successiva in un'enumerazione che inizia con una chiamata a BeginEnumeration.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametri

vFunc
[in] Questo parametro è inutilizzato.

ptr
[in] Puntatore a un'istanza di IWbemClassObject .

lFlags
[in] Riservato. Questo parametro deve essere 0.

pstrName
[out] Nuovo BSTR che contiene il nome della proprietà. È possibile impostare questo parametro su null se il nome non è obbligatorio.

pVal
[out] Oggetto VARIANT compilato con il valore della proprietà. È possibile impostare questo parametro su null se il valore non è obbligatorio. Se la funzione restituisce un codice di errore, il VARIANT passaggio a pVal viene lasciato non modificato.

pvtType
[out] Puntatore a una CIMTYPE variabile (in LONG cui viene inserito il tipo della proprietà). Il valore di questa proprietà può essere un VT_NULL_VARIANT, nel qual caso è necessario determinare il tipo effettivo della proprietà. Questo parametro può anche essere null.

plFlavor
[out] nullo un valore che riceve informazioni sull'origine della proprietà. Per i valori possibili, vedere la sezione [Osservazioni].

Valore restituito

I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:

Costante	Valore	Descrizione
`WBEM_E_FAILED`	0x80041001	Si è verificato un errore generale.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Un parametro non è valido.
`WBEM_E_UNEXPECTED`	0x8004101d	Non è stata eseguita alcuna chiamata alla `BeginEnumeration` funzione.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Memoria insufficiente disponibile per avviare una nuova enumerazione.
`WBEM_E_TRANSPORT_FAILURE`	0x80041015	La chiamata alla procedura remota tra il processo corrente e Gestione di Windows non è riuscita.
`WBEM_S_NO_ERROR`	0	La chiamata alla funzione ha avuto esito positivo.
`WBEM_S_NO_MORE_DATA`	0x40005	Nell'enumerazione non sono presenti più proprietà.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::Next .

Questo metodo restituisce anche le proprietà di sistema.

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 l'oggetto CIMTYPE per la proprietà specificata per determinare se la proprietà è un riferimento a un oggetto, una data o un'ora o un altro tipo speciale.

Se plFlavor non nullè , il LONG valore riceve informazioni sull'origine della proprietà, come indicato di seguito:

Costante	Valore	Descrizione
`WBEM_FLAVOR_ORIGIN_SYSTEM`	0x40	La proprietà è una proprietà di sistema standard.
`WBEM_FLAVOR_ORIGIN_PROPAGATED`	0x20	Per una classe: la proprietà viene ereditata dalla classe padre. Per un'istanza: la proprietà, ereditata dalla classe padre, non è stata modificata dall'istanza.
`WBEM_FLAVOR_ORIGIN_LOCAL`	0	Per una classe: la proprietà appartiene alla classe derivata. Per un'istanza: la proprietà viene modificata dall'istanza; ovvero, è stato fornito un valore o è stato aggiunto o modificato un qualificatore.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche

WMI e contatori delle prestazioni (riferimenti alle API non gestite)

Condividi tramite