estrutura CF_SYNC_REGISTRATION (cfapi.h)
Os detalhes do provedor de sincronização e da raiz de sincronização a serem registrados.
Sintaxe
typedef struct CF_SYNC_REGISTRATION {
ULONG StructSize;
LPCWSTR ProviderName;
LPCWSTR ProviderVersion;
LPCVOID SyncRootIdentity;
DWORD SyncRootIdentityLength;
LPCVOID FileIdentity;
DWORD FileIdentityLength;
GUID ProviderId;
} CF_SYNC_REGISTRATION;
Membros
StructSize
O tamanho da estrutura CF_SYNC_REGISTRATION .
ProviderName
O nome do provedor de sincronização. Essa é uma cadeia de caracteres amigável com um comprimento máximo de 255 caracteres.
ProviderVersion
A versão do provedor de sincronização. Essa é uma cadeia de caracteres amigável com um comprimento máximo de 255 caracteres.
SyncRootIdentity
A identidade raiz de sincronização usada pelo provedor. Esse membro é opcional com um tamanho máximo de 64 KB. A API falha com ERROR_INVALID_PARAMETER quando o comprimento máximo é excedido. A plataforma fornecerá SyncRootIdentity de volta ao provedor de sincronização em quaisquer retornos de chamada para o provedor de sincronização.
SyncRootIdentityLength
O comprimento da SyncRootIdentity. Esse membro é opcional e só será usado se uma SyncRootIdentity for fornecida.
FileIdentity
Uma identidade de arquivo opcional. Esse membro tem um tamanho máximo de 4 KB. A API falha com ERROR_INVALID_PARAMETER quando o comprimento máximo é excedido. O blob fileIdentity raiz de sincronização será fornecido somente quando o assunto do retorno de chamada for a própria raiz de sincronização.
FileIdentityLength
O comprimento da FileIdentity. Esse membro é opcional e só será usado se uma FileIdentity for fornecida.
ProviderId
Esse é um GUID destinado a identificar um provedor de sincronização específico. É opcional. Se não for fornecida, a plataforma gerará um GUID usando o hash MD5 da cadeia de caracteres ProviderName . As informações são usadas apenas para telemetria, de modo que a plataforma possa correlacionar melhor as atividades do mesmo provedor de sincronização com mais eficiência e precisão, mesmo que o provedor de sincronização registre raízes de sincronização com cadeias de caracteres ProviderName diferentes. É recomendável que um provedor de sincronização sempre forneça o mesmo GUID para todas as versões de seus produtos de sincronização. Por outro lado, os provedores de sincronização são livres para escolher diferentes cadeias de caracteres ProviderName para obter a melhor experiência do usuário.
Comentários
SyncRootIdentity e SyncRootIdentityLength são membros opcionais. Se não for usado, defina SyncRootIdentity como nullptr e SyncRootIdentityLength como 0. FileIdentity e FileIdentityLength também são opcionais e, se não forem usados, devem ser definidos nullptr como e 0, respectivamente.
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] |
| Cabeçalho | cfapi.h |