Méthode ISyncMgrSyncCallback ::QueryForAdditionalItems (syncmgr.h)

Article
03/04/2024

Récupère un énumérateur de l’ensemble d’éléments qui ont une demande en attente à synchroniser. Il s’agit de l’ensemble d’éléments qui seront synchronisés une fois la synchronisation actuelle terminée.

Syntaxe

HRESULT QueryForAdditionalItems(
  [out] IEnumString  **ppenumItemIDs,
  [out] IEnumUnknown **ppenumPunks
);

Paramètres

[out] ppenumItemIDs

Type : IEnumString**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers un instance d’IEnumString qui énumère les ID d’élément de synchronisation. Cette valeur est NULL si aucun élément n’est en attente.

[out] ppenumPunks

Type : IEnumUnknown**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers un instance d’interfaces IEnumUnknown énumérant IUnknown qui sont passées à StartHandlerSync ou StartItemSync. Cette valeur est NULL si aucune interface n’est en attente.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. Retourne S_FALSE si aucun élément n’est en attente.

Remarques

Les ID d’élément récupérés par un appel à la méthode Next de l’interface énumératrice récupérée ont une longueur maximale de MAX_SYNCMGR_ID y compris le caractère null de fin. L’application appelante est responsable de la désaffectation de chaque ID d’élément récupéré via la méthode Next à l’aide de CoTaskMemFree.

Configuration requise

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

Partager via