Função CfReportSyncStatus (cfapi.h)

Permite que um provedor de sincronização notifique a plataforma de seu status em uma raiz de sincronização especificada sem precisar se conectar com uma chamada para CfConnectSyncRoot primeiro.

Sintaxe

HRESULT CfReportSyncStatus(
  [in, out] LPCWSTR        SyncRootPath,
  [in]      CF_SYNC_STATUS *SyncStatus
);

Parâmetros

[in, out] SyncRootPath

Caminho para a raiz de sincronização.

[in] SyncStatus

A sincronização status para relatar; se NULL, limpa a sincronização salva anteriormente status. Para obter mais informações, consulte a seção Comentários , abaixo.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando uma CF_SYNC_STATUS não nula for fornecida no parâmetro SyncStatus , as informações serão lembradas na raiz de sincronização até que sejam desmarcadas explicitamente pelo provedor de sincronização ou quando o computador for reiniciado. A plataforma consultará essas informações sobre quaisquer operações com falha em um espaço reservado de arquivo de nuvem, usando o seguinte processo:

1. A plataforma primeiro procurará status de sincronização no nível do arquivo.
2. Se nenhuma status de sincronização for encontrada, a plataforma procurará sincronização status registrada no nível raiz de sincronização, o que é feito por meio dessa função.
3. Depois que um status de sincronização estiver localizado, a plataforma usará as informações fornecidas para construir uma mensagem mais significativa e acionável para o usuário.

CfReportSyncStatus limpa o status de sincronização salvo anteriormente ao ser chamado com uma NULL status de sincronização. Nenhuma alteração será feita na sincronização existente status se a chamada de função falhar.

Requisitos

Confira também

CfConnectSyncRoot

CF_SYNC_STATUS