PrjStartVirtualizing 함수(projectedfslib.h)

ProjFS 가상화 instance 구성하고 이를 시작하여 I/O를 서비스하고 공급자에서 콜백을 호출할 수 있도록 합니다.

구문

HRESULT PrjStartVirtualizing(
  [in]           PCWSTR                               virtualizationRootPath,
  [in]           const PRJ_CALLBACKS                  *callbacks,
  [in, optional] const void                           *instanceContext,
  [in, optional] const PRJ_STARTVIRTUALIZING_OPTIONS  *options,
  [out]          PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT *namespaceVirtualizationContext
);

매개 변수

[in] virtualizationRootPath

가상화 루트 디렉터리에 대한 전체 경로를 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

공급자는 이 루틴을 호출하기 전에 지정된 경로를 rootPathName 매개 변수로 전달하고 NULL을 targetPathName 매개 변수로 전달하는 PrjMarkDirectoryAsPlaceholder 를 호출해야 합니다. 경로를 가상화 루트 디렉터리로 지정하려면 한 번만 수행하면 됩니다.

[in] callbacks

공급자의 콜백 함수에 대한 포인터로 채워진 PRJ_CALLBACKS 구조체에 대한 포인터입니다.

[in, optional] instanceContext

각 instance 대해 공급자가 정의한 컨텍스트 정보에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 지정된 경우 ProjFS는 공급자 콜백 루틴을 호출할 때 PRJ_CALLBACK_DATA InstanceContext 멤버에 반환합니다.

[in, optional] options

PRJ_STARTVIRTUALIZING_OPTIONS 대한 선택적 포인터입니다.

[out] namespaceVirtualizationContext

성공 시 ProjFS 가상화 instance 불투명 핸들을 반환합니다. 공급자는 입력으로 PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT 필요한 함수를 호출할 때 이 값을 전달합니다.

반환 값

HRESULT_FROM_WIN32(ERROR_REPARSE_TAG_MISMATCH) 오류는 virtualizationRootPath가 가상화 루트로 구성되지 않음을 나타냅니다.

요구 사항

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