Função CfSetInSyncState (cfapi.h)

  • Artigo

Define o estado de sincronização de um arquivo ou pasta de espaço reservado.

Sintaxe

HRESULT CfSetInSyncState(
  [in]                HANDLE               FileHandle,
  [in]                CF_IN_SYNC_STATE     InSyncState,
  [in]                CF_SET_IN_SYNC_FLAGS InSyncFlags,
  [in, out, optional] USN                  *InSyncUsn
);

Parâmetros

[in] FileHandle

Um identificador para o espaço reservado. A plataforma sincroniza corretamente a operação com outras solicitações ativas. Um identificador de atributo ou sem acesso é suficiente. O chamador deve ter acesso WRITE_DATA ou WRITE_DAC ao espaço reservado.

[in] InSyncState

O estado de sincronização. InSyncState pode ser definido como um dos seguintes valores:

  • Se CF_IN_SYNC_STATE_NOT_IN_SYNC for especificado, a plataforma limpará o estado de sincronização do espaço reservado após um retorno bem-sucedido da chamada à API.
  • Se CF_IN_SYNC_STATE_IN_SYNC for especificado, a plataforma definirá o estado de sincronização do espaço reservado após um retorno bem-sucedido da chamada à API.

[in] InSyncFlags

Os sinalizadores de estado em sincronia. Consulte CF_SET_IN_SYNC_FLAGS para obter mais detalhes.

[in, out, optional] InSyncUsn

Quando especificado, na entrada, o InSyncUsn instrui a plataforma a executar apenas a configuração em sincronização se o arquivo ainda tiver o mesmo valor de USN que aquele passado. Isso é para fechar uma corrida em que o provedor de sincronização tem apenas o espaço reservado sync'd muda para a nuvem, mas antes da chamada para CfSetInSyncState, o espaço reservado foi alterado de alguma forma. Passar um ponteiro para um valor USN de 0 na entrada é o mesmo que passar um NULL ponteiro. No retorno, InSYncUsn recebe o valor final de USN depois de definir o estado de sincronização.

Retornar valor

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho cfapi.h
Biblioteca CldApi.lib
DLL CldApi.dll

Confira também

CF_IN_SYNC_STATE

CF_SET_IN_SYNC_FLAGS