Metodo ISyncMgrSessionCreator::CreateSession (syncmgr.h)

Articolo
03/05/2024

Notifica al Centro sincronizzazione che la sincronizzazione degli elementi specificati è iniziata.

Sintassi

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

Parametri

[in] pszHandlerID

Tipo: LPCWSTR

Puntatore a un buffer contenente l'ID univoco del gestore. Questa stringa è di lunghezza massima MAX_SYNCMGR_ID incluso il carattere null di terminazione.

[in] ppszItemIDs

Tipo: LPCWSTR*

Indirizzo di un puntatore a un buffer contenente una matrice di ID elemento, gestiti dal gestore specificato in pszHandlerID, da sincronizzare. Ogni ID è di lunghezza massima MAX_SYNCMGR_ID incluso il carattere Null di terminazione.

[in] cItems

Tipo: ULONG

Numero di ID elemento contenuti nel buffer a cui si fa riferimento in ppszItemIDs.

[in] ppCallback

Tipo: ISyncMgrSyncCallback**

Indirizzo di un puntatore a un'istanza di ISyncMgrSyncCallback utilizzato per segnalare lo stato di avanzamento e gli eventi. Questo valore può essere NULL se non è necessario alcun callback.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È necessario specificare sia pszHandlerID che ppszItemIDs .

Esempio

Nell'esempio seguente viene illustrata la struttura di un'implementazione di questo metodo.

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

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

    return hr;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	syncmgr.h

Condividi tramite