Metodo ISyncMgrSynchronize::P repareForSync (mobsync.h)

Articolo
08/24/2023

Consente a un'applicazione registrata di visualizzare qualsiasi interfaccia utente ed eseguire qualsiasi inizializzazione necessaria prima che venga chiamato il metodo ISyncMgrSynchronize::Synchronize . Ad esempio, un'applicazione come il client di posta elettronica di Microsoft Outlook potrebbe dover visualizzare la finestra di dialogo password per consentire a un utente di accedere a un server di posta elettronica.

Sintassi

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

Parametri

[in] cbNumItems

Tipo: ULONG

Numero di elementi nella matrice a cui punta pItemIDs.

[in] pItemIDs

Tipo: GUID*

Matrice di ID elemento che un utente sceglie di sincronizzare.

[in] hWndParent

Tipo: HWND

Handle per hWND padre che deve essere usato da un'applicazione registrata per qualsiasi elemento dell'interfaccia utente visualizzato. Questo valore può essere NULL.

[in] dwReserved

Tipo: DWORD

Riservato. Le applicazioni registrate devono ignorare questo valore.

Valore restituito

Tipo: HRESULT

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY e gli elementi seguenti:

Codice restituito	Descrizione
S_OK	La preparazione ha esito positivo.

Commenti

Un gestore dell'applicazione registrato deve restituire da questo metodo il prima possibile e quindi chiamare il metodo PrepareForSyncCompleted . Un gestore dell'applicazione registrato può chiamare il metodo PrepareForSyncCompleted prima di restituire da questo metodo.

Le applicazioni registrate devono mostrare un'interfaccia utente solo se il flag SYNCMGRFLAG_MAYBOTHERUSER è impostato nel parametro dwSyncFlags del metodo ISyncMgrSynchronize::Initialize . Se un'applicazione registrata non è in grado di preparare la sincronizzazione senza visualizzare un'interfaccia utente quando il flag SYNCMGRFLAG_MAYBOTHERUSER non è impostato, deve restituire S_FALSE da questo metodo.

Anche la matrice di ID elemento passati a questo metodo è rilevante per il metodo ISyncMgrhronize::Synchronize .

I metodi ISyncMgrHronizeCallback possono essere chiamati in qualsiasi thread in un'applicazione registrata.

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