IWbemContext::Next-Methode (wbemcli.h)
Die IWbemContext::Next-Methode ruft den nächsten Wert in einer Enumeration aller Kontextwerte ab, die mit IWbemContext::BeginEnumeration beginnen.
Syntax
HRESULT Next(
[in] long lFlags,
[out] BSTR *pstrName,
[out] VARIANT *pValue
);
Parameter
[in] lFlags
Reserviert. Dieser Parameter muss 0 sein.
[out] pstrName
Dieser Parameter darf nicht NULL sein. Der Zeiger darf nicht auf einen aktiven BSTR-Eintrag zeigen, und im Idealfall sollte er auf NULL festgelegt werden. Wenn kein Fehlercode zurückgegeben wird, wird festgelegt, dass er auf einen neu zugeordneten BSTR verweist, der den Kontextwertnamen enthält.
Der Aufrufer muss SysFreeString für die zurückgegebene Zeichenfolge aufrufen, wenn sie nicht mehr benötigt wird. Wenn WBEM_S_NO_MORE_DATA zurückgibt, wird pstrName auf NULL festgelegt. In diesem Fall sollte SysFreeString nicht aufgerufen werden. Wenn pstrName beim Eintrag auf einen gültigen BSTR verweist, wird dieser BSTR nicht freigegeben, und es tritt ein Speicherverlust auf.
[out] pValue
Dieser Parameter darf nicht NULL sein, und er muss auf einen leeren oder nicht initialisierten VARIANT-Wert verweisen. Wenn kein Fehler zurückgegeben wird, wird variant mit VariantInit initialisiert und dann auf den Kontextwert festgelegt. Der Aufrufer muss VariantClear für diesen Zeiger aufrufen, wenn der Wert nicht mehr benötigt wird. Wenn ein Fehlercode zurückgegeben wird, bleibt der VARIANT-Wert , auf den pValue verweist, unverändert.
Wenn WBEM_S_NO_MORE_DATA zurückgibt, wird dieser Parameter so festgelegt, dass er auf einen VARIANT-Wert vom Typ VT_NULL zeigt.
Es ist möglich, dass ein gesamtes IWbemClassObject-Objekt innerhalb des VARIANT-Objekts zurückgegeben wird. Wenn dies der Fall ist, ist VT_UNKNOWN der VARIANT-Typ . Der Aufrufer kann den IUnknown-Zeiger verwenden und QueryInterface ausführen, um den IWbemClassObject-Zeiger abzurufen.
Rückgabewert
Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wbemcli.h (include Wbemidl.h) |
| Bibliothek | Wbemuuid.lib |
| DLL | Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll |