CfExecute 함수(cfapi.h)

모든 연결 키 기반 자리 표시자 작업에 대한 기본 진입점입니다. 동기화 공급자가 플랫폼의 다양한 콜백에 응답하는 데 사용됩니다.

구문

HRESULT CfExecute(
  [in]      const CF_OPERATION_INFO *OpInfo,
  [in, out] CF_OPERATION_PARAMETERS *OpParams
);

매개 변수

[in] OpInfo

자리 표시자의 작업에 대한 정보입니다.

[in, out] OpParams

자리 표시자에 대한 작업의 매개 변수입니다.

반환 값

이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

CfExecute에 대한 유효한 호출은 동일한 동기화 공급자 프로세스에 속하는 보류 중인 모든 콜백 요청의 타이머를 다시 설정합니다.

CfExecute 는 두 개의 변수 크기 인수(예: CF_OPERATION_INFO 및 CF_OPERATION_PARAMETERS)를 사용합니다. 하나는 작업 유형을 식별하고 다른 하나는 자세한 작업 매개 변수를 제공합니다. 두 인수 모두 해당 구조체의 시작 부분에 있는 StructSize 필드로 시작합니다. CfExecute의 호출자는 구조 크기에 대한 정확한 회계를 담당합니다.

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

필요에 따라 동기화 공급자는 플랫폼에 동기화 상태 Blob을 제공할 수 있습니다. null이 아닌 포인터가 CF_OPERATION_INFO SyncStatus 필드에 설정된 경우 해당 콘텐츠는 마지막 핸들이 제거될 때까지 파일에 유지됩니다. 플랫폼은 클라우드 파일 자리 표시자에서 실패한 작업에 대해 이 정보를 쿼리합니다. 사용할 수 있는 경우 플랫폼은 제공된 정보를 사용하여 사용자에게 더 의미 있고 실행 가능한 메시지를 생성합니다.

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

모든 작업은 동기화 공급자 프로세스의 임의 스레드 컨텍스트에서 수행할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	cfapi.h
라이브러리	CldApi.lib
DLL	CldApi.dll

추가 정보

CfConnectSyncRoot

CfGetCorrelationVector

CF_OPERATION_INFO

CF_OPERATION_PARAMETERS