ISyncMgrSessionCreator ::CreateSession, méthode (syncmgr.h)

Article
03/02/2024

Avertit le Centre de synchronisation que la synchronisation des éléments spécifiés a commencé.

Syntaxe

HRESULT CreateSession(
  [in] LPCWSTR              pszHandlerID,
  [in] LPCWSTR              *ppszItemIDs,
  [in] ULONG                cItems,
  [in] ISyncMgrSyncCallback **ppCallback
);

Paramètres

[in] pszHandlerID

Type : LPCWSTR

Pointeur vers une mémoire tampon contenant l’ID unique du gestionnaire. Cette chaîne a une longueur maximale MAX_SYNCMGR_ID y compris le caractère null de fin.

[in] ppszItemIDs

Type : LPCWSTR*

Adresse d’un pointeur vers une mémoire tampon contenant un tableau d’ID d’élément, géré par le gestionnaire spécifié dans pszHandlerID, à synchroniser. Chaque ID a une longueur maximale MAX_SYNCMGR_ID y compris le caractère null de fin.

[in] cItems

Type : ULONG

Nombre d’ID d’élément contenus dans la mémoire tampon référencée dans ppszItemIDs.

[in] ppCallback

Type : ISyncMgrSyncCallback**

Adresse d’un pointeur vers un instance de ISyncMgrSyncCallback utilisé pour signaler la progression et les événements. Cette valeur peut être NULL si aucun rappel n’est nécessaire.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

PszHandlerID et ppszItemID doivent être spécifiés.

Exemples

L’exemple suivant montre le plan d’une implémentation de cette méthode.

STDMETHODIMP CMyDeviceHandler::Synchronize(...)
{
    ...
    ISyncMgrSyncCallback *pCallback = NULL;

    hr = pCreator->CreateSession(_pszHandlerID, ppszItemIDs, cItems, &pCallback);
    if (SUCCEEDED(hr))
    {
        // Perform synchronization.
    }

    return hr;
}

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