IFsiDirectoryItem::get_Item 方法 (imapi2fs.h)
從檔案系統映像擷取指定的目錄或檔案專案。
語法
HRESULT get_Item(
[in] BSTR path,
[out] IFsiItem **item
);
參數
[in] path
包含要擷取之專案路徑的字串。
[out] item
所要求目錄或檔案專案的 IFsiItem 介面。
傳回值
S_OK會在成功時傳回,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:
傳回碼 | Description |
---|---|
|
路徑 '%1!s!' 格式不正確或包含無效字元。
值:0xC0AAB110 |
|
指標無效。
值:0x80004003 |
|
為參數 %1!ls! 指定的值無效。
值:0xC0AAB101 |
|
在 FileSystemImage 階層中找不到專案 %1!ls! 。
值:0xC0AAB118 |
|
無法配置必要的記憶體。
值:0x8007000E |
備註
若要判斷專案是否為檔案專案或目錄專案,請呼叫 IFsiItem::QueryInterface 方法,傳遞__uuidof (IFsiDirectoryItem) 作為介面標識符。 如果呼叫成功,則專案為目錄專案;否則,專案是檔案專案。
若要列舉所有子系,請呼叫 IFsiDirectoryItem::get__NewEnum 方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | imapi2fs.h |
另請參閱
IFsiFileItem