共用方式為


IFsiDirectoryItem::get_Item 方法 (imapi2fs.h)

從檔案系統映像擷取指定的目錄或檔案專案。

語法

HRESULT get_Item(
  [in]  BSTR     path,
  [out] IFsiItem **item
);

參數

[in] path

包含要擷取之專案路徑的字串。

[out] item

所要求目錄或檔案專案的 IFsiItem 介面。

傳回值

S_OK會在成功時傳回,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 Description
IMAPI_E_INVALID_PATH
路徑 '%1!s!' 格式不正確或包含無效字元。

值:0xC0AAB110

E_POINTER
指標無效。

值:0x80004003

IMAPI_E_INVALID_PARAM
為參數 %1!ls! 指定的值無效。

值:0xC0AAB101

IMAPI_E_ITEM_NOT_FOUND
在 FileSystemImage 階層中找不到專案 %1!ls!

值:0xC0AAB118

E_OUTOFMEMORY
無法配置必要的記憶體。

值:0x8007000E

備註

若要判斷專案是否為檔案專案或目錄專案,請呼叫 IFsiItem::QueryInterface 方法,傳遞__uuidof (IFsiDirectoryItem) 作為介面標識符。 如果呼叫成功,則專案為目錄專案;否則,專案是檔案專案。

若要列舉所有子系,請呼叫 IFsiDirectoryItem::get__NewEnum 方法。

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 imapi2fs.h

另請參閱

IFsiDirectoryItem

IFsiFileItem