estrutura CF_SYNC_STATUS (cfapi.h)
Usado em uma estrutura CF_OPERATION_INFO para descrever o status de uma raiz de sincronização especificada.
Sintaxe
typedef struct CF_SYNC_STATUS {
ULONG StructSize;
ULONG Code;
ULONG DescriptionOffset;
ULONG DescriptionLength;
ULONG DeviceIdOffset;
ULONG DeviceIdLength;
} CF_SYNC_STATUS;
Membros
StructSize
O tamanho, em bytes, da estrutura de status de sincronização, incluindo a cadeia de caracteres de descrição real.
Code
O uso desse parâmetro cabe completamente ao provedor de sincronização que dá suporte a essa sincronização avançada status constructo.
Para um provedor de sincronização específico, espera-se que haja um mapeamento 1:1 entre o código e a cadeia de caracteres de descrição.
É recomendável que você use a ordem de bits mais alta para descrever o tipo de código de erro: 1 para um código no nível de erro e 0 para um código de nível de informação.
Observação
O código é opaco para a plataforma e é usado apenas para fins de acompanhamento.
DescriptionOffset
O deslocamento da cadeia de caracteres de descrição em relação ao início do CF_SYNC_STATUS. Ele aponta para uma cadeia de caracteres larga terminada em nulo localizada que deve conter informações mais significativas e acionáveis sobre o arquivo em questão. Espera-se que os provedores de sincronização equilibrem o requisito de fornecer informações mais acionáveis e manter um volume de memória o menor possível.
DescriptionLength
O tamanho da cadeia de caracteres de descrição, em bytes, que inclui o terminador nulo.
DeviceIdOffset
O deslocamento de um blob de ID do dispositivo em relação ao início do CF_SYNC_STATUS. O blob de ID do dispositivo é opcional e opaco para a plataforma. Espera-se que o blob seja exclusivo por dispositivo. Se fornecido, o blob será coletado como parte da telemetria da plataforma para ajudar a diagnosticar problemas técnicos.
DeviceIdLength
O tamanho do blob de ID do dispositivo, em bytes.
Comentários
Se um ponteiro nulo for definido no campo SyncStatus de uma estrutura CF_OPERATION_INFO, a plataforma limpará a status de sincronização definida anteriormente, se houver uma.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1803 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Cabeçalho | cfapi.h |