다음을 통해 공유


CF_PLACEHOLDER_CREATE_INFO 구조체(cfapi.h)

새 자리 표시자 파일 또는 디렉터리를 만들기 위한 자리 표시자 정보를 포함합니다.

구문

typedef struct CF_PLACEHOLDER_CREATE_INFO {
  LPCWSTR                     RelativeFileName;
  CF_FS_METADATA              FsMetadata;
  LPCVOID                     FileIdentity;
  DWORD                       FileIdentityLength;
  CF_PLACEHOLDER_CREATE_FLAGS Flags;
  HRESULT                     Result;
  USN                         CreateUsn;
} CF_PLACEHOLDER_CREATE_INFO;

멤버

RelativeFileName

만들 자식 자리 표시자 파일 또는 디렉터리의 이름입니다. 파일 또는 디렉터리 이름으로만 구성되어야 합니다.

예를 들어 공급자의 동기화 루트가 C:\SyncRoot인 경우 동기화 루트의 하위 디렉터리에 placeholder.txt 자리 표시자를 만들려면 BaseDirectoryPath가 와 같은 C:\SyncRoot\SubDirectoryCfCreatePlaceholders 함수를 호출하고 CF_PLACEHOLDER_CREATE_INFOplaceholder.txtRelativePathName 필드를 로 설정합니다.

FsMetadata

모든 타임스탬프, 파일 특성 및 파일 크기(디렉터리에 대한 선택 사항)를 포함하여 자리 표시자를 사용하여 만들 파일 시스템 메타데이터입니다.

FileIdentity

동기화 공급자가 제공한 파일 정보를 포함하는 사용자 모드 버퍼입니다. FileIdentity Blob은 크기가 CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH(4KB로 정의됨)를 초과하면 안 됩니다. FileIdentity 는 모든 콜백에서 동기화 공급자에 다시 전달됩니다. 이는 파일(디렉터리에는 필요 없음)에 필요합니다.

FileIdentityLength

FileIdentity의 길이(바이트)입니다.

Flags

자리 표시자 만들기 동작을 지정하기 위한 플래그입니다. 자세한 내용은 CF_PLACEHOLDER_CREATE_FLAGS 참조하세요.

Result

자리 표시자를 만든 결과입니다. 성공적으로 만들면 값이 STATUS_OK.

CreateUsn

만들기 작업이 수행된 후의 최종 USN 값입니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
머리글 cfapi.h

추가 정보

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders