Compartilhar via

IReplStore::ReportStatus

  • Artigo

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Este método é chamado pelo Gerenciador ActiveSync para get informações em status de sincronização.

Syntax

HRESULT ReportStatus(
  HREPLFLD hFolder,
  HREPLITEM hItem,
  UINT uStatus,
  UINT uParam
);

Parameters

  • hFolder
    [no] Identificador para a pasta que esse status se aplica ao. Este parâmetro é NULL se status se aplica a todas as pastas.
  • hItem
    [no] Identificador para o objeto que esse status se aplica ao. Este parâmetro é NULL se status se aplica a todos os objetos.
  • uStatus
    [out] Um do seguinte status códigos.

  • RSC_BEGIN_SYNC
    Sincronização é sobre para iniciar. uReserved é uma combinação do seguinte sinalizadores bit.

    Sinalizador Description

    BSF_AUTO_SYNC

    Sincronização é iniciada como resultado de alterações enquanto "autosync em alteração" está ativado.

    BSF_REMOTE_SYNC

    Consistente com RSC_REMOTE_SYNC, defina se sincronização é feita remotamente.
  • RSC_END_SYNC
    A sincronização foi finalizada.
  • RSC_BEGIN_CHECK
    O Gerenciador ActiveSync é sobre chamar FindFirstItem e MapVirtualKey. FindNextItem.
  • RSC_END_CHECK
    O Gerenciador ActiveSync concluiu todas as chamadas enumeração e FindItemClose foi chamado.
  • RSC_DATE_CHANGED
    O usuário foi alterado de data a sistema. Este codificar é chamado em cada objeto existente na armazenar para dar o provedor serviço ActiveSync uma chance redefinir a data-dependente opções sincronização. De exemplo, se um provedor serviço ActiveSync desejar sincronizar os arquivos que são modificados nas duas últimas semanas, ele pode responder a esta codificar para redefinir o bit habilitar para cada item. Quando IsItemReplicated é chamado posteriormente, ele avalia os itens baseados na nova data.
  • RSC_RELEASE
    O Gerenciador ActiveSync for sobre a versão de IReplStore object. Isso é chamado antes de final IReplStore::Release chamar.
  • RSC_REMOTE_SYNC
    Se uParam é TRUE, o ActiveSync Gerenciador é sobre remoto iniciar sincronização. O provedor serviço ActiveSync não deve apresentação qualquer interface do usuário que requer interação usuário from Now on até esse codificar status é usado novamente com uParam igual a FALSE.

  • RSC_INTERRUPT
    Gerenciador ActiveSync trata a interrupção a atual operação. O seguinte valores de uParam são definidas somente para RSC_INTERRUPT.

    Value Description

    PSA_RESET_INTERRUPT

    Este sinalizador está definido se o estado interrupção está sendo desmarcado — operação normal está continuando.

    PSA_SYS_SHUTDOWN

    Usuário foi desligado a sistema operacional do Windows.
  • RSC_BEGIN_SYNC_OBJ
    Sincronização é sobre para iniciar em um tipo objeto. uReserved é uma combinação de sinalizadores bit. Consulte RSC_BEGIN_SYNC.
  • RSC_END_SYNC_OBJ
    A sincronização está prestes a terminar em um tipo objeto.
  • RSC_OBJ_TYPE_ENABLED
    Sincronização do objeto especificado está habilitado. hFolder é um ponteiro para uma seqüência de caracteres (Nome tipo objeto).
  • RSC_OBJ_TYPE_DISABLED
    Sincronização do objeto especificado está desativada. hFolder é um ponteiro para uma seqüência de caracteres (Nome tipo objeto).
  • RSC_BEGIN_BATCH_WRITE
    Uma série de SetPackets chamado em um número de objetos. Este é o tempo para provedor serviço ActiveSync para iniciar uma transação.
  • RSC_END_BATCH_WRITE
    RSC_BEGIN_BATCH_WRITE terminou. Este é o tempo para o provedor serviço ActiveSync a confirmação de transação.
  • RSC_CONNECTION_CHG
    O status conexão foi alterada. uParam é TRUE se uma conexão foi estabelecida; caso contrário, é FALSE.
  • RSC_WRITE_OBJ_FAILED
    Houve uma falha ao gravar em um objeto sobre o dispositivo. uParam é a codificar HRESULT.
  • RSC_WRITE_OBJ_SUCCESS
    Gravação de um objeto com êxito no dispositivo. uParam é um ponteiro para SDREQUEST, COM (lpbData, cbData) que representa o volume ID.
  • RSC_DELETE_OBJ_SUCCESS
    A exclusão de um objeto com êxito no dispositivo. uParam é um ponteiro para SDREQUEST, COM (lpbData, cbData) que representa o volume ID.
  • RSC_READ_OBJ_FAILED
    Falha ao ler um objeto a partir de dispositivo. uParam é a codificar HRESULT.
  • RSC_TIME_CHANGED
    Tempo do sistema foi alterada. Isso é chamado somente uma vez.
  • RSC_BEGIN_BACKUP
    Backup é sobre para iniciar.
  • RSC_END_BACKUP
    O backup foi finalizada.
  • RSC_BEGIN_RESTORE
    Restauração trata para iniciar.
  • RSC_PREPARE_SYNC_FLD
    Preparar-se para sincronizar uma pasta específica ou não todos os objetos de tipo são sujos. hFolder é um ponteiro ao nome do objeto que vai ser sincronizado.

  • RSC_DELETE_OBJ_FAILED
    Houve uma falha ao excluir um objeto sobre o dispositivo. uParam é a codificar HRESULT.

    Codificar o status pode ser uma do seguinte valores.

    Value Description

    RSC_BEGIN_BACKUP

    O backup está prestes a começar.

    RSC_END_BACKUP

    O backup foi finalizada.

    RSC_BEGIN_RESTORE

    Restauração está prestes a começar.

    RSC_END_RESTORE

    A restauração foi finalizada.
  • uParam
    [no] Informações adicionais sobre o status, com base em uStatus codificar.

Return Value

Retorna NOERROR se o processo indicada por uStatus é bem-sucedido. Retornará E_FAIL se o processo indicada por uStatus Tem falha ou encontrou problemas.

Se uStatus Especifica RSC_WRITE_OBJ_FAILED, o método retorna RERR_SKIP_ALL_OBJ para ignorar sincronização de todos os objetos restantes.

Remarks

O provedor serviço ActiveSync pode retornar NOERROR para todos os casos se ele não está interessado.

Este é um aplicativo interface de programação (API) exportada pelo Store.dll para o mecanismo sincronização.

Requirements

Header cesync.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IReplStore