CF_OPERATION_INFO 구조체(cfapi.h)

아티클
02/26/2024

자리 표시자 파일 또는 폴더의 작업에 대한 정보입니다.

구문

typedef struct CF_OPERATION_INFO {
  ULONG                    StructSize;
  CF_OPERATION_TYPE        Type;
  CF_CONNECTION_KEY        ConnectionKey;
  CF_TRANSFER_KEY          TransferKey;
  const CORRELATION_VECTOR *CorrelationVector;
  const CF_SYNC_STATUS     *SyncStatus;
  CF_REQUEST_KEY           RequestKey;
} CF_OPERATION_INFO;

멤버

StructSize

CF_OPERATION_INFO 구조체의 크기입니다.

Type

수행 중인 작업의 유형입니다. 자세한 내용은 CF_OPERATION_TYPE 참조하세요.

ConnectionKey

통신 채널에 대해 가져온 연결 키입니다.

TransferKey

자리 표시자에 대한 불투명 핸들입니다.

CorrelationVector

원격 분석 목적으로 사용되는 자리 표시자의 상관 관계 벡터입니다.

SyncStatus

참고

이 멤버는 Windows 10 버전 1803의 새로운 멤버입니다.

플랫폼의 현재 CF_SYNC_STATUS .

플랫폼은 클라우드 파일 자리 표시자에서 실패한 작업에 대해 이 정보를 쿼리합니다. 구조를 사용할 수 있는 경우 플랫폼은 제공된 정보를 사용하여 사용자에게 더 의미 있고 실행 가능한 메시지를 생성합니다. 플랫폼은 마지막 핸들이 사라질 때까지 파일에 이 정보를 유지합니다. SyncStatus가 null이면 플랫폼이 이전에 설정한 동기화 상태 지웁습니다(있는 경우).

RequestKey

특정 클라우드 파일에서 클라우드 파일 작업을 고유하게 식별하는 불투명 ID입니다.

설명

플랫폼은 CfConnectSyncRoot를 통해 등록된 모든 콜백 함수에 ConnectionKey, TransferKey 및 CorrelationVector를 제공합니다. 또한 동기화 공급자는 CfGetTransferKey를 사용하여 TransferKey를 가져오고 CfGetCorrelationVector를 사용하여 CorrelationVector를 가져올 수 있습니다.

요구 사항

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