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 |