IOpcPartEnumerator::MoveNext method (msopc.h)

Article
02/22/2024

Moves the current position of the enumerator to the next IOpcPart interface pointer.

Syntax

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

Parameters

[out, retval] hasNext

A Boolean value that indicates the status of the IOpcPart interface pointer at the current position.

The value of hasNext is only valid when the method succeeds.

Value	Meaning
TRUE	The current position of the enumerator has been advanced to the next pointer and that pointer is valid.
FALSE	The current position of the enumerator has been advanced past the end of the collection and is no longer valid.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code/value	Description
S_OK	The method succeeded.
E_POINTER	The hasNext parameter is NULL.
OPC_E_ENUM_CANNOT_MOVE_NEXT 0x80510051	The current position is already past the last item of the enumerator.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	The enumerator is invalid because the underlying set has changed.

Remarks

When an enumerator is created, the current position precedes the first pointer. To set the current position to the first pointer of the enumerator, call the MoveNext method after creating the enumerator.

Thread Safety

Packaging objects are not thread-safe.

For more information, see the Getting Started with the Packaging API.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	msopc.h

Share via