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 |
|---|---|
|
L'inizializzazione ha esito positivo. |
|
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 |