IOpcPartEnumerator::MoveNext-Methode (msopc.h)

Artikel
03/04/2024

Verschiebt die aktuelle Position des Enumerators zum nächsten IOpcPart-Schnittstellenzeiger .

Syntax

HRESULT MoveNext(
  [out, retval] BOOL *hasNext
);

Parameter

[out, retval] hasNext

Ein boolescher Wert, der die status des IOpcPart-Schnittstellenzeigers an der aktuellen Position angibt.

Der Wert von hasNext ist nur gültig, wenn die Methode erfolgreich ist.

Wert	Bedeutung
true	Die aktuelle Position des Enumerators wurde zum nächsten Zeiger erweitert, und dieser Zeiger ist gültig.
false	Die aktuelle Position des Enumerators wurde über das Ende der Auflistung erweitert und ist nicht mehr gültig.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der hasNext-Parameter ist NULL.
OPC_E_ENUM_CANNOT_MOVE_NEXT 0x80510051	Die aktuelle Position liegt bereits hinter dem letzten Element des Enumerators.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	Der Enumerator ist ungültig, da sich der zugrunde liegende Satz geändert hat.

Hinweise

Wenn ein Enumerator erstellt wird, liegt die aktuelle Position vor dem ersten Zeiger. Um die aktuelle Position auf den ersten Zeiger des Enumerators festzulegen, rufen Sie die MoveNext-Methode auf, nachdem Sie den Enumerator erstellt haben.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h