Metodo IOpcPartEnumerator::MoveNext (msopc.h)

Articolo
03/05/2024

Sposta la posizione corrente dell'enumeratore al puntatore di interfaccia IOpcPart successivo.

Sintassi

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

Parametri

[out, retval] hasNext

Valore booleano che indica lo stato del puntatore all'interfaccia IOpcPart nella posizione corrente.

Il valore di hasNext è valido solo quando il metodo ha esito positivo.

Valore	Significato
true	La posizione corrente dell'enumeratore è stata avanzata al puntatore successivo e tale puntatore è valido.
FALSE	La posizione corrente dell'enumeratore è stata avanzata oltre la fine della raccolta e non è più valida.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice/valore restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro hasNext è NULL.
OPC_E_ENUM_CANNOT_MOVE_NEXT 0x80510051	La posizione corrente è già passata all'ultimo elemento dell'enumeratore.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	L'enumeratore non è valido perché il set sottostante è stato modificato.

Commenti

Quando viene creato un enumeratore, la posizione corrente precede il primo puntatore. Per impostare la posizione corrente sul primo puntatore dell'enumeratore, chiamare il metodo MoveNext dopo aver creato l'enumeratore.

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h