Método ISyncMgrSynchronize::P repareForSync (mobsync.h)

Artigo
08/24/2023

Permite que um aplicativo registrado exiba qualquer interface do usuário e execute qualquer inicialização necessária antes que o método ISyncMgrSynchronize::Synchronize seja chamado. Por exemplo, um aplicativo como o cliente de email do Microsoft Outlook pode precisar exibir a caixa de diálogo de senha para permitir que um usuário faça logon em um servidor de email.

Sintaxe

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

Parâmetros

[in] cbNumItems

Tipo: ULONG

O número de itens na matriz apontada por pItemIDs.

[in] pItemIDs

Tipo: GUID*

Uma matriz de IDs de item que um usuário opta por sincronizar.

[in] hWndParent

Digite: HWND

Um identificador para o HWND pai que um aplicativo registrado deve usar para qualquer elemento de interface do usuário exibido. Esse valor pode ser NULL.

[in] dwReserved

Tipo: DWORD

Reservado. Os aplicativos registrados devem ignorar esse valor.

Valor retornado

Tipo: HRESULT

Esse método dá suporte aos valores retornados padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, e o seguinte:

Código de retorno	Descrição
S_OK	A preparação foi bem-sucedida.

Comentários

Um manipulador de aplicativo registrado deve retornar desse método assim que possível e, em seguida, chamar o método PrepareForSyncCompleted . Um manipulador de aplicativo registrado pode chamar o método PrepareForSyncCompleted antes de retornar desse método.

Os aplicativos registrados só deverão mostrar uma interface do usuário se o sinalizador SYNCMGRFLAG_MAYBOTHERUSER estiver definido no parâmetro dwSyncFlags do método ISyncMgrSynchronize::Initialize . Se um aplicativo registrado não puder se preparar para sincronização sem mostrar uma interface do usuário quando o sinalizador SYNCMGRFLAG_MAYBOTHERUSER não estiver definido, ele deverá retornar S_FALSE desse método.

A matriz de IDs de item que são passadas para esse método também são relevantes para o método ISyncMgrSynchronize::Synchronize .

Os métodos ISyncMgrSynchronizeCallback podem ser chamados em qualquer thread em um aplicativo registrado.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mobsync.h
DLL	Mobsync.dll