Share via


CfGetCorrelationVector 함수(cfapi.h)

동기화 공급자가 지정된 자리 표시자 파일에 대한 현재 상관 관계 벡터를 쿼리할 수 있습니다. 파일이 처음 열렸을 때 플랫폼에서 자동으로 할당된 항목이거나 CfSetCorrelationVector를 통해 명시적으로 할당된 파일입니다.

구문

HRESULT CfGetCorrelationVector(
  [in]  HANDLE              FileHandle,
  [out] PCORRELATION_VECTOR CorrelationVector
);

매개 변수

[in] FileHandle

자리 표시자 파일에 대한 핸들입니다. 플랫폼은 작업을 다른 활성 요청과 올바르게 동기화합니다. 특성 또는 액세스 권한 없음 핸들로 충분합니다.

[out] CorrelationVector

현재 FileHandle과 연결된 상관 관계 벡터입니다.

반환 값

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

설명

호출자는 수분을 공급할 자리 표시자에 대한 READ_DATA 또는 WRITE_DAC 액세스 권한이 있어야 합니다. 그렇지 않으면 STATUS_CLOUD_FILE_ACCESS_DENIED 작업이 실패합니다.

요구 사항

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

추가 정보

CfSetCorrelationVector