ISyncMgrControl ::UpdateItem, méthode (syncmgr.h)
Informe le Centre de synchronisation que les propriétés d’un élément de synchronisation ont été modifiées.
Syntaxe
HRESULT UpdateItem(
[in] LPCWSTR pszHandlerID,
[in] LPCWSTR pszItemID,
[in] SYNCMGR_CONTROL_FLAGS nControlFlags
);
Paramètres
[in] pszHandlerID
Type : LPCWSTR
Pointeur vers une mémoire tampon contenant l’ID unique du gestionnaire qui gère l’élément. Cette chaîne a une longueur maximale MAX_SYNCMGR_ID y compris le caractère null de fin.
[in] pszItemID
Type : LPCWSTR
Pointeur vers une mémoire tampon contenant l’ID unique de l’élément. Cette chaîne a une longueur maximale MAX_SYNCMGR_ID y compris le caractère null de fin.
[in] nControlFlags
Type : SYNCMGR_CONTROL_FLAGS
Valeur de l’énumération SYNCMGR_CONTROL_FLAGS spécifiant si la mise à jour doit être effectuée de manière synchrone ou asynchrone.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Si SYNCMGR_CF_WAIT est défini dans le paramètre nControlFlags , UpdateItem ne retourne pas tant que le Centre de synchronisation n’a pas chargé le gestionnaire spécifié et rechargé toutes les informations relatives au gestionnaire et à l’élément. Si le gestionnaire est fourni par une collection de gestionnaires, la collection de gestionnaires est également chargée pour recharger le gestionnaire.
Exemples
L’exemple suivant montre l’utilisation d’ISyncMgrControl ::UpdateItem par la procédure d’un gestionnaire.
void CMyDeviceHandler::MiscProc(...)
{
...
// Get the Sync Center control object.
ISyncMgrControl *pControl = NULL;
hr = CoCreateInstance(CLSID_SyncMgrControl,
CLSCTX_SERVER,
IID_PPV_ARGS(&pControl));
if (SUCCEEDED(hr))
{
// Tell Sync Center that properties of the item have changed.
hr = pControl->UpdateItem(s_szMySyncHandlerID,
s_szMySyncHandlerMusicContentID,
SYNCMGR_CF_WAIT);
pControl->Release();
}
...
}
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 |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour