PrjWritePlaceholderInfo 함수(projectedfslib.h)

파일 또는 디렉터리 메타데이터를 ProjFS로 보냅니다.

구문

HRESULT PrjWritePlaceholderInfo(
  [in] PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in] PCWSTR                               destinationFileName,
  [in] const PRJ_PLACEHOLDER_INFO           *placeholderInfo,
  [in] UINT32                               placeholderInfoSize
);

매개 변수

[in] namespaceVirtualizationContext

가상화 instance 대한 불투명 핸들입니다. 이는 PRJ_GET_PLACEHOLDER_INFO_CB 콜백 에서 공급자에게 전달된 callbackData의 VirtualizationInstanceHandle 멤버의 값이어야 합니다.

[in] destinationFileName

자리 표시자를 만들 파일 또는 디렉터리에 대한 가상화 루트를 기준으로 경로를 지정하는 null로 종료된 유니코드 문자열입니다.

이는 PRJ_GET_PLACEHOLDER_INFO_CB 콜백 에서 공급자에게 전달된 callbackData 매개 변수의 FilePathName 멤버와 일치해야 합니다. 공급자는 PrjFileNameCompare 함수를 사용하여 두 이름이 일치하는지 여부를 확인해야 합니다.

예를 들어 PRJ_GET_PLACEHOLDER_INFO_CB 콜백이 callbackData-FilePathName>에서 "dir1\dir1\FILE.TXT"을 지정하고 공급자의 지원 저장소에 dir1\dir2 디렉터리에 "File.txt"이라는 파일이 포함되어 있고 PrjFileNameCompare 가 "FILE.TXT" 및 "File.txt" 이름을 비교할 때 0을 반환하는 경우 공급자는 이 매개 변수의 값으로 "dir1\dir2\File.txt"을 지정합니다.

[in] placeholderInfo

파일 또는 디렉터리에 대한 메타데이터에 대한 포인터입니다.

[in] placeholderInfoSize

placeholderInfo가 가리키는 버퍼의 크기(바이트)입니다.

반환 값

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

설명

공급자는 이 루틴을 사용하여 PRJ_GET_PLACEHOLDER_INFO_CB 콜백을 호출할 때 요청된 데이터를 제공하거나 자리 표시자를 사전에 배치하는 데 사용할 수 있습니다.

PRJ_PLACEHOLDER_INFO EaInformation, SecurityInformation 및 StreamsInformation 멤버는 선택 사항입니다. 공급자가 확장 특성, 사용자 지정 보안 설명자 또는 대체 데이터 스트림을 제공하지 않으려면 이러한 필드를 0으로 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1809[데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	projectedfslib.h