PrjFillDirEntryBuffer2 函式 (projectedfslib.h)

提供一個檔案或目錄至列舉的資訊，並允許呼叫端指定擴充資訊。

語法

HRESULT PrjFillDirEntryBuffer2(
  [in]           PRJ_DIR_ENTRY_BUFFER_HANDLE dirEntryBufferHandle,
  [in]           PCWSTR                      fileName,
  [in, optional] PRJ_FILE_BASIC_INFO         *fileBasicInfo,
  [in, optional] PRJ_EXTENDED_INFO           *extendedInfo
);

參數

[in] dirEntryBufferHandle

結構的不透明句柄，可接收填滿專案的相關信息。

[in] fileName

包含項目名稱之 Null 終止字串的指標

[in, optional] fileBasicInfo

要填入之專案的基本資訊。

[in, optional] extendedInfo

PRJ_EXTENDED_INFO結構的指標，指定要填入之專案的擴充資訊。

傳回值

HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER) 表示 dirEntryBufferHandle 沒有足夠的空間可供新專案使用。

E_INVALIDARG表示 extendedInfo.InfoType 無法辨識。

備註

提供者會使用此例程來服務 PRJ_GET_DIRECTORY_ENUMERATION_CB回 呼。 處理回呼時，提供者會針對列舉中的每個相符檔案或目錄呼叫這個例程。 這個例程可讓提供者指定檔案或目錄的擴充資訊，例如是否為符號連結。

如果這個例程在將專案新增至列舉時傳回HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER) ，提供者會從回呼傳回S_OK，並等候下一個 PRJ_GET_DIRECTORY_ENUMERATION_CB回 呼。

提供者會繼續填入列舉，其中包含在取得HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER) 时尝试新增的项目。

如果這個例程傳回HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER) PRJ_GET_DIRECTORY_ENUMERATION_CB回呼期間新增 的第一個專案 ，提供者必須從回呼傳回HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER) 。

符號連結

若要指定此目錄專案適用於符號連結，提供者會使用單一 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