Método ISyncMgrControl::StartItemSync (syncmgr.h)

Inicia a sincronização de itens especificados gerenciados por um manipulador específico.

Sintaxe

HRESULT StartItemSync(
  [in] LPCWSTR                    pszHandlerID,
  [in] LPCWSTR                    *ppszItemIDs,
  [in] ULONG                      cItems,
  [in] HWND                       hwndOwner,
  [in] IUnknown                   *punk,
  [in] SYNCMGR_SYNC_CONTROL_FLAGS nSyncControlFlags,
  [in] ISyncMgrSyncResult         *pResult
);

Parâmetros

[in] pszHandlerID

Tipo: LPCWSTR

Um ponteiro para um buffer que contém a ID exclusiva do manipulador que gerencia os itens. Essa cadeia de caracteres tem o comprimento máximo MAX_SYNCMGR_ID incluindo o caractere nulo de terminação.

[in] ppszItemIDs

Tipo: LPCWSTR*

O endereço de um ponteiro para um buffer que contém uma matriz de IDs dos itens a serem sincronizados. Cada ID tem o comprimento máximo MAX_SYNCMGR_ID incluindo o caractere nulo de terminação. Essa matriz é passada para Sincronizar.

[in] cItems

Tipo: DWORD

O número de IDs em ppszItemIDs.

[in] hwndOwner

Digite: HWND

Um identificador para a janela que o item pode usar para exibir qualquer interface do usuário necessária. Esse valor pode ser NULL.

[in] punk

Tipo: IUnknown*

Um ponteiro para um IUnknown a ser passado para Sincronizar. Este parâmetro pode ser NULL.

[in] nSyncControlFlags

Tipo: SYNCMGR_SYNC_CONTROL_FLAGS

Um membro da enumeração SYNCMGR_SYNC_CONTROL_FLAGS que especifica se um item encontrado em uma sincronização atual e uma sincronização na fila deve ser sincronizado novamente quando a sincronização na fila é executada.

[in] pResult

Tipo: ISyncMgrSyncResult*

Um ponteiro para uma instância de ISyncMgrSyncResult, cujo método Result é chamado quando a sincronização termina, seja por êxito, falha ou cancelamento. O método Result é chamado com o estado agregado da sincronização do manipulador. Este parâmetro pode ser NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é análogo a UpdateItems.

Exemplos

O exemplo a seguir mostra o uso de ISyncMgrControl::StartItemSync pelo procedimento de um manipulador.

void CMyDeviceHandler::MiscProc(...)
{
    ...

    // Get the Sync Center control object.
    ISyncMgrControl *pControl = NULL;
    
    hr = CoCreateInstance(CLSID_SyncMgrControl, 
                          CLSCTX_SERVER,
                          IID_PPV_ARGS(&pControl));
    if (SUCCEEDED(hr))
    {
        // Synchronize one sync item for the sync handler.
        hr = pControl->StartItemSync(s_szMySyncHandlerID,
                                     s_szMySyncHandlerMusicContentID,
                                     1,
                                     _hwnd,
                                     NULL,
                                     NULL);
        pControl->Release();
    }

    ...

}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	syncmgr.h