CfGetPlaceholderInfo 함수(cfapi.h)
자리 표시자 파일 또는 폴더의 다양한 특성을 가져옵니다. 파일이 클라우드 파일 자리 표시자가 아니면 API가 실패합니다. 성공하면 요청된 특정 InfoClass 에 따라 정보가 반환됩니다.
구문
HRESULT CfGetPlaceholderInfo(
[in] HANDLE FileHandle,
[in] CF_PLACEHOLDER_INFO_CLASS InfoClass,
[out] PVOID InfoBuffer,
[in] DWORD InfoBufferLength,
[out, optional] PDWORD ReturnedLength
);
매개 변수
[in] FileHandle
정보를 쿼리할 자리 표시자에 대한 핸들입니다. 파일 핸들을 사용하는 대부분의 클라우드 파일 API와 달리 이 API는 어떤 방식으로도 파일을 수정하지 않습니다. 따라서 파일 핸들에는 READ_ATTRIBUTES 액세스만 필요합니다.
[in] InfoClass
자리 표시자 정보입니다. CF_PLACEHOLDER_STANDARD_INFO 또는CF_PLACEHOLDER_BASIC_INFO 설정할 수 있습니다.
[out] InfoBuffer
자리 표시자에 대한 정보를 수신할 버퍼에 대한 포인터입니다.
[in] InfoBufferLength
InfoBuffer의 길이(바이트)입니다. 버퍼가 요청된 모든 정보를 보유할 만큼 크지 않은 경우 API는 버퍼에 들어갈 수 있는 만큼의 데이터를 반환하고 HRESULT_FROM_WIN32(ERROR_MORE_DATA)으로 호출이 실패합니다.
[out, optional] ReturnedLength
InfoBuffer에 반환된 바이트 수입니다.
반환 값
이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
자리 표시자 정보에는 다음 특성이 포함됩니다.
| attribute | Description |
|---|---|
| OnDiskDataSize | 디스크의 총 바이트 수입니다. |
| ValidatedDataSize | 클라우드와 동기화되는 총 바이트 수입니다. |
| ModifiedDataSize | 로컬에서 덮어쓰기/추가된 총 바이트 수(예: 클라우드와 동기화되지 않음)입니다. |
| PropertiesSize | 모든 속성 Blob에서 사용되는 디스크의 총 바이트 수입니다. |
| PinState | 자세한 내용은 CfSetPinState 를 참조하세요. |
| InSyncState | 자세한 내용은 CfSetInSyncState 를 참조하세요. |
| FileId | 파일 또는 디렉터리를 고유하게 식별하는 64비트 볼륨 너비의 비휘발성 숫자입니다. |
| SyncRootFileId | 자리 표시자 정보를 쿼리할 파일이 있는 동기화 루트 디렉터리의 파일 ID입니다. |
| FileIdentity | 자리 표시자를 만들 때 동기화 공급자가 플랫폼에 제공한 불투명 Blob입니다. 파일 ID는 모든 동기화 공급자 콜백에 대해 제공됩니다. |
| FileIdentityLength | 파일 ID의 길이(바이트)입니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | cfapi.h |
| 라이브러리 | CldApi.lib |
| DLL | CldApi.dll |