Metodo ISyncMgrSynchronize::Initialize (mobsync.h)

Chiamato dalla gestione sincronizzazione in un gestore dell'applicazione registrato per determinare se il gestore elabora l'evento di sincronizzazione.

Sintassi

HRESULT Initialize(
  [in] DWORD      dwReserved,
  [in] DWORD      dwSyncMgrFlags,
  [in] DWORD      cbCookie,
  [in] const BYTE *lpCookie
);

Parametri

[in] dwReserved

Tipo: DWORD

Riservati; deve essere 0 (zero).

[in] dwSyncMgrFlags

Tipo: DWORD

I valori di enumerazione SYNCMGRFLAG che descrivono come viene avviato un evento di sincronizzazione.

[in] cbCookie

Tipo: DWORD

Dimensioni dei dati lpCookie , in byte.

[in] lpCookie

Tipo: BYTE const*

Puntatore al token che identifica un'applicazione. Questo token viene passato quando un'applicazione richiama la gestione sincronizzazione a livello di codice.

Valore restituito

Tipo: HRESULT

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY e i seguenti.

Codice restituito Descrizione
S_OK
L'inizializzazione ha esito positivo.
S_FALSE
Il gestore dell'applicazione non elabora un evento di sincronizzazione.

Commenti

I valori di enumerazione SYNCMGRFLAG si applicano alla durata dell'interfaccia ISyncMgrSynchronize e vengono usati dagli altri metodi ISyncMgrSynchronize .

Se un'applicazione non riconosce l'evento SYNCMGRFLAG , l'applicazione deve considerare l'evento come sincronizzazione manuale.

Un gestore applicazione registrato non può visualizzare un'interfaccia utente all'interno di questa chiamata, a meno che non sia la prima volta che viene chiamato il metodo di inizializzazione. Un'applicazione può visualizzare qualsiasi inizializzazione una volta necessaria per configurare gli elementi e introdurre un utente a una funzionalità dell'applicazione. Se è necessario visualizzare un'interfaccia utente per un motivo diverso nell'ambito del processo di sincronizzazione, è possibile usare il metodo ISyncMgrSynchronize::P repareForSync .

Il parametro lpCookie è NULL a meno che un'applicazione di gestione richiama a livello di codice la gestione sincronizzazione usando UpdateItems. In questo scenario, l'identificatore di classe (CLSID) identifica l'applicazione di gestione e il valore di lpCookie viene passato dall'applicazione di gestione e quindi passato di nuovo dalla gestione della sincronizzazione durante la sincronizzazione per il contesto. Il parametro lpCookie è significativo solo quando viene impostato SYNCMGRFLAG_INVOKE .

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mobsync.h
DLL Mobsync.dll

Vedi anche

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems