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

추가 정보

GetOverlappedResult

CF_PIN_STATE

CF_SET_PIN_FLAGS