IOpcRelationshipEnumerator::MoveNext method (msopc.h)

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

Syntax

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

Parameters

[out, retval] hasNext

A Boolean value that indicates the status of the IOpcRelationship 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

See also

Getting Started with the Packaging API

IOpcRelationshipEnumerator

IOpcRelationshipSet

Overviews

Packaging API Reference

Packaging API Samples

Packaging Errors

Reference