PRJ_GET_PLACEHOLDER_INFO_CB projectedfslib.h (回呼函式)

向提供者要求檔案或目錄的資訊。

語法

PRJ_GET_PLACEHOLDER_INFO_CB PrjGetPlaceholderInfoCb;

HRESULT PrjGetPlaceholderInfoCb(
  [in] const PRJ_CALLBACK_DATA *callbackData
)
{...}

[in] callbackData

作業的相關信息。實作此回呼需要下列 callbackData 成員：

FilePathName 識別提供者存放區中要求資訊之 ProjFS 檔案或目錄的路徑。

提供者會使用此名稱來判斷名稱是否存在於其備份儲存區中。它應該使用 PrjFileNameMatch 函式來比較此名稱與其存放區中的名稱。如果找到相符的名稱，它會使用該名稱作為 PrjWritePlaceholderInfo 函式的 destinationFileName 參數。

VersionInfo 提供所要求專案之父目錄的版本資訊。

提供者只能在回呼執行時存取此緩衝區。如果它想要寫入作業，而且它需要來自這個緩衝區的數據，它就必須建立自己的複本。

傳回碼	描述
S_OK	檔案存在於提供者的存放區中，且已成功將檔案的資訊提供給 ProjFS。
HRESULT_FROM_WIN32 (ERROR_IO_PENDING)	提供者希望稍後完成作業。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	檔案不存在於提供者的存放區中。

如果提供者失敗作業，則為另一個適當的 HRESULT 錯誤碼。

ProjFS 會使用此回呼中提供的資訊，為要求的專案建立佔位元。

為了處理此回呼，提供者會呼叫 PrjWritePlaceholderInfo ，為 ProjFS 提供要求檔名的資訊。然後提供者會完成回呼。