CF_SYNC_REGISTRATION 구조체(cfapi.h)

등록할 동기화 공급자 및 동기화 루트의 세부 정보입니다.

구문

typedef struct CF_SYNC_REGISTRATION {
  ULONG   StructSize;
  LPCWSTR ProviderName;
  LPCWSTR ProviderVersion;
  LPCVOID SyncRootIdentity;
  DWORD   SyncRootIdentityLength;
  LPCVOID FileIdentity;
  DWORD   FileIdentityLength;
  GUID    ProviderId;
} CF_SYNC_REGISTRATION;

멤버

StructSize

CF_SYNC_REGISTRATION 구조체의 크기입니다.

ProviderName

동기화 공급자의 이름입니다. 최대 길이가 255자인 사용자에게 친숙한 문자열입니다.

ProviderVersion

동기화 공급자의 버전입니다. 최대 길이가 255자인 사용자에게 친숙한 문자열입니다.

SyncRootIdentity

공급자가 사용하는 동기화 루트 ID입니다. 이 멤버는 최대 크기가 64KB인 선택 사항입니다. 최대 길이를 초과하면 ERROR_INVALID_PARAMETER API가 실패합니다. 플랫폼은 동기화 공급자에 대한 모든 콜백에서 SyncRootIdentity 를 동기화 공급자에 다시 제공합니다.

SyncRootIdentityLength

SyncRootIdentity의 길이입니다. 이 멤버는 선택 사항이며 SyncRootIdentity 가 제공된 경우에만 사용됩니다.

FileIdentity

선택적 파일 ID입니다. 이 멤버의 최대 크기는 4KB입니다. 최대 길이를 초과하면 ERROR_INVALID_PARAMETER API가 실패합니다. 동기화 루트 FileIdentity Blob은 콜백의 주체가 동기화 루트 자체인 경우에만 제공됩니다.

FileIdentityLength

FileIdentity의 길이입니다. 이 멤버는 선택 사항이며 FileIdentity 가 제공된 경우에만 사용됩니다.

ProviderId

특정 동기화 공급자를 식별하기 위한 GUID입니다. 이는 선택 사항입니다. 제공되지 않으면 플랫폼은 ProviderName 문자열의 MD5 해시를 사용하여 GUID를 생성합니다. 이 정보는 동기화 공급자가 서로 다른 ProviderName 문자열에 동기화 루트를 등록하는 경우에도 플랫폼이 동일한 동기화 공급자의 활동을 보다 효율적이고 정확하게 상호 연결할 수 있도록 원격 분석에만 사용됩니다. 동기화 공급자는 항상 동기화 제품의 모든 버전에 대해 동일한 GUID를 제공하는 것이 좋습니다. 반면에 동기화 공급자는 최상의 사용자 환경을 위해 다양한 ProviderName 문자열을 자유롭게 선택할 수 있습니다.

설명

SyncRootIdentity 및 SyncRootIdentityLength 는 선택적 멤버입니다. 사용하지 않으면 SyncRootIdentity 를 로 nullptr 설정하고 SyncRootIdentityLength 를 로 0설정합니다. FileIdentity 및 FileIdentityLength도 선택 사항이며 사용하지 않는 경우 각각 및 0로 nullptr 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
머리글	cfapi.h

추가 정보

CfRegisterSyncRoot