다음을 통해 공유

PrjWritePlaceholderInfo2 함수(projectedfslib.h)

  • 아티클

파일 또는 디렉터리 메타데이터를 ProjFS로 보내고 호출자가 확장 정보를 지정할 수 있도록 합니다.

구문

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

매개 변수

[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가 가리키는 버퍼의 크기(바이트)입니다.

ExtendedInfo

만들 자리 표시자에 대한 확장 정보를 지정하는 PRJ_EXTENDED_INFO 구조체에 대한 포인터입니다.

반환 값

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

설명

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

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

이 자리 표시자를 기호 링크로 지정하기 위해 공급자는 단일 PRJ_EXTENDED_INFO 구조체로 버퍼의 형식을 지정하고 매개 변수에서 extendedInfo 포인터를 전달합니다. 공급자는 구조체의 필드를 다음과 같이 설정합니다.

  • extendedInfo.InfoType = PRJ_EXT_INFO_TYPE_SYMLINK
  • extendedInfo.NextInfoOffset = 0
  • extendedInfo.Symlink.TargetName = <path to the target of the symbolic link>

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 버전 2004(10.0; 빌드 19041)
지원되는 최소 서버 Windows Server 버전 2004(10.0; 빌드 19041)
대상 플랫폼 Windows
헤더 projectedfslib.h