CfSetPinState 함수(cfapi.h)
이렇게 하면 사용자의 의도를 나타내는 데 사용되는 자리 표시자의 핀 상태가 설정됩니다. 동기화 공급자뿐만 아니라 모든 애플리케이션에서 이 함수를 호출할 수 있습니다.
구문
HRESULT CfSetPinState(
[in] HANDLE FileHandle,
[in] CF_PIN_STATE PinState,
[in] CF_SET_PIN_FLAGS PinFlags,
[in, out, optional] LPOVERLAPPED Overlapped
);
매개 변수
[in] FileHandle
자리 표시자 파일의 핸들입니다. 플랫폼은 작업을 다른 활성 요청과 올바르게 동기화합니다. 특성 또는 액세스 권한 없음 핸들로 충분합니다. 호출자에게 자리 표시자에 대한 READ_DATA 또는 WRITE_DAC 액세스 권한이 있어야 합니다. 그렇지 않으면 작업이 STATUS_CLOUD_FILE_ACCESS_DENIED 실패합니다.
[in] PinState
자리 표시자 파일의 핀 상태입니다. 유효한 PinState 값 목록은 CF_PIN_STATE 참조하세요.
[in] PinFlags
핀 상태 플래그입니다. PinFlags는 다음 값으로 설정할 수 있습니다.
- CF_PIN_FLAG_RECURSE 지정하면 플랫폼은 핀 상태를 FileHandle에 적용하고 그 아래에 있는 모든 파일을 재귀적으로 적용합니다(FileHandle이 디렉터리에 대한 핸들인 경우에만 관련됨).
- CF_PIN_FLAG_RECURSE_ONLY 지정한 경우 플랫폼은 FileHandle 아래에 있는 모든 파일에 핀 상태를 재귀적으로 적용하지만 FileHandle 자체에는 적용되지 않습니다.
- CF_PIN_FLAG_RECURSE_STOP_ERROR 지정하면 플랫폼이 첫 번째 오류가 발생할 때 재귀를 중지합니다. 그렇지 않으면 플랫폼이 오류를 건너뛰고 재귀를 계속합니다.
[in, out, optional] Overlapped
호출을 비동기적으로 수행할 수 있습니다. 자세한 내용은 설명 섹션을 참조하세요.
반환 값
이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
지정하고 비동기 FileHandle과 결합하면 겹침 을 사용하면 플랫폼이 호출을 비동기적으로 수행할 수 있습니다.
호출자는 대기할 이벤트를 사용하여 겹치는 구조를 초기화해야 합니다. HRESULT_FROM_WIN32(ERROR_IO_PENDING)를 반환하면 호출자는 GetOverlappedResult를 사용하여 대기할 수 있습니다. 지정하지 않으면 플랫폼은 핸들을 만든 방법에 관계없이 동기적으로 API 호출을 수행합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | cfapi.h |
| 라이브러리 | CldApi.lib |
| DLL | CldApi.dll |