Método IOpcRelationshipEnumerator::MoveNext (msopc.h)

Artigo
03/13/2024

Move a posição atual do enumerador para o próximo ponteiro da interface IOpcRelationship .

Sintaxe

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

Parâmetros

[out, retval] hasNext

Um valor booliano que indica o status do ponteiro da interface IOpcRelationship na posição atual.

O valor de hasNext só é válido quando o método é bem-sucedido.

Valor	Significado
TRUE	A posição atual do enumerador foi avançada para o próximo ponteiro e esse ponteiro é válido.
FALSE	A posição atual do enumerador foi avançada após o final da coleção e não é mais válida.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor/código retornado	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro hasNext é NULL.
OPC_E_ENUM_CANNOT_MOVE_NEXT 0x80510051	A posição atual já está além do último item do enumerador.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	O enumerador é inválido porque o conjunto subjacente foi alterado.

Comentários

Quando um enumerador é criado, a posição atual precede o primeiro ponteiro. Para definir a posição atual como o primeiro ponteiro do enumerador, chame o método MoveNext depois de criar o enumerador.

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h