IFsiDirectoryItem::get_Item 方法 (imapi2fs.h)

从文件系统映像中检索指定的目录或文件项。

语法

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

参数

[in] path

包含要检索的项的路径的字符串。

[out] item

请求的目录或文件项的 IFsiItem 接口。

返回值

S_OK成功后返回,但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
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