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

Article
02/29/2024

Déplace la position actuelle de l’énumérateur vers le pointeur d’interface IOpcRelationship suivant.

Syntaxe

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

Paramètres

[out, retval] hasNext

Valeur booléenne qui indique le status du pointeur de l’interface IOpcRelationship à la position actuelle.

La valeur de hasNext n’est valide que lorsque la méthode réussit.

Valeur	Signification
TRUE	La position actuelle de l’énumérateur a été avancée jusqu’au pointeur suivant et ce pointeur est valide.
FALSE	La position actuelle de l’énumérateur a été avancée au-delà de la fin de la collection et n’est plus valide.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code/valeur de retour	Description
S_OK	S_OK
E_POINTER	Le paramètre hasNext est NULL.
OPC_E_ENUM_CANNOT_MOVE_NEXT 0x80510051	La position actuelle est déjà au-delà du dernier élément de l’énumérateur.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	L’énumérateur n’est pas valide, car le jeu sous-jacent a changé.

Remarques

Lorsqu’un énumérateur est créé, la position actuelle précède le premier pointeur. Pour définir la position actuelle sur le premier pointeur de l’énumérateur, appelez la méthode MoveNext après avoir créé l’énumérateur.

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API d’empaquetage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h