共用方式為

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

虛擬化實例的不透明句柄。 這必須是PRJ_GET_PLACEHOLDER_INFO_CB回呼中傳遞至提供者的 callbackData VirtualizationInstanceHandle 成員的值。

[in] destinationFileName

以 Null 結束的 Unicode 字串，指定要建立佔位元之檔案或目錄的路徑，相對於虛擬化根目錄。

這必須與傳遞至 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

佔位元Info 所指向緩衝區的位元大小。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

提供者會使用此例程來提供叫用 其PRJ_GET_PLACEHOLDER_INFO_CB 回呼時所要求的數據，或者可以使用它主動配置佔位符。

PRJ_PLACEHOLDER_INFO 的 EaInformation、SecurityInformation 和 StreamsInformation 成員是選擇性的。 如果提供者不想要提供擴充屬性、自定義安全性描述元或替代數據流，則必須將這些欄位設定為 0。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1809 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server [僅限傳統型應用程式]
目標平台 Windows
標頭 projectedfslib.h