Funzione QualifierSet_Next

Articolo
04/08/2023

Recupera il qualificatore successivo in un'enumerazione avviata con una chiamata alla funzione QualifierSet_BeginEnumeration.

Nota

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

Sintassi

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parametri

vFunc [in] Questo parametro non è usato.

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

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

pstrName [out] Nome del qualificatore. Se null, questo parametro viene ignorato; in caso contrario, pstrName non deve puntare a una perdita di memoria valida BSTR o si verifica una perdita di memoria. Se non null, la funzione alloca sempre un nuovo BSTR oggetto quando restituisce WBEM_S_NO_ERROR.

pVal [out] In caso di esito positivo, il valore del qualificatore. Se la funzione ha esito negativo, l'oggetto VARIANT a cui pVal punta non viene modificato. Se questo parametro è null, il parametro viene ignorato.

plFlavor [out] Puntatore a un valore LONG che riceve il sapore del qualificatore. Se le informazioni sul sapore non sono desiderate, questo parametro può essere null.

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_INVALID_PARAMETER`	0x80041008	Un parametro non è valido.
`WBEM_E_UNEXPECTED`	0x8004101d	Il chiamante non ha chiamato QualifierSet_BeginEnumeration.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Memoria insufficiente per iniziare una nuova enumerazione.
`WBEM_S_NO_MORE_DATA`	0x40005	Nell'enumerazione non vengono lasciati altri qualificatori.
`WBEM_S_NO_ERROR`	0	La chiamata di funzione ha avuto esito positivo.

Commenti

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

Chiamare ripetutamente la QualifierSet_Next funzione per enumerare tutti i qualificatori fino a quando la funzione non restituisce WBEM_S_NO_MORE_DATA. Per terminare l'enumerazione in anticipo, chiamare la funzione QualifierSet_EndEnumeration .

L'ordine dei qualificatori restituiti durante l'enumerazione non è definito.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile dalla versione 4.7.2

Vedi anche

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

Condividi tramite