Share via


CF_SYNC_STATUS 구조체(cfapi.h)

CF_OPERATION_INFO 구조에서 지정된 동기화 루트의 상태 설명하는 데 사용됩니다.

구문

typedef struct CF_SYNC_STATUS {
  ULONG StructSize;
  ULONG Code;
  ULONG DescriptionOffset;
  ULONG DescriptionLength;
  ULONG DeviceIdOffset;
  ULONG DeviceIdLength;
} CF_SYNC_STATUS;

멤버

StructSize

실제 설명 문자열을 포함하여 동기화 상태 구조체의 크기(바이트)입니다.

Code

이 매개 변수의 사용은 이 풍부한 동기화 상태 구문을 지원하는 동기화 공급자에 달려 있습니다.

특정 동기화 공급자의 경우 코드와 설명 문자열 사이에 1:1 매핑이 있을 것으로 예상됩니다.

가장 높은 비트 순서를 사용하여 오류 코드 유형( 1 오류 수준 코드 및 정보 수준 코드 0 )을 설명하는 것이 좋습니다.

참고

코드 는 플랫폼에 불투명하며 추적 목적으로만 사용됩니다.

DescriptionOffset

CF_SYNC_STATUS 시작을 기준으로 하는 설명 문자열의 오프셋입니다. 해당 파일에 대한 보다 의미 있고 실행 가능한 정보를 포함할 것으로 예상되는 지역화된 null로 끝나는 와이드 문자열을 가리킵니다. 동기화 공급자는 더 많은 실행 가능한 정보를 제공하고 가능한 한 작은 메모리 공간을 유지 관리해야 하는 요구 사항의 균형을 유지해야 합니다.

DescriptionLength

null 종결자를 포함하는 설명 문자열의 크기(바이트)입니다.

DeviceIdOffset

CF_SYNC_STATUS 시작을 기준으로 하는 디바이스 ID Blob의 오프셋입니다. 디바이스 ID Blob은 선택 사항이며 플랫폼에 불투명합니다. Blob은 디바이스별로 고유해야 합니다. 제공된 경우 Blob은 기술 문제를 진단하는 데 도움이 되는 플랫폼 원격 분석의 일부로 수집됩니다.

DeviceIdLength

디바이스 ID Blob의 크기(바이트)입니다.

설명

CF_OPERATION_INFO 구조체의 SyncStatus 필드에 null 포인터가 설정된 경우 플랫폼은 이전에 설정한 동기화 상태 지웁합니다(있는 경우).

요구 사항

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

추가 정보

CF_OPERATION_INFO