IFileSystemImage：：CreateFileItem 方法 (imapi2fs.h)

创建具有指定名称的文件项。

语法

HRESULT CreateFileItem(
  [in]  BSTR         name,
  [out] IFsiFileItem **newItem
);

parameters

[in] name

包含要创建的文件项的名称的字符串。

[out] newItem

新文件项的 IFsiFileItem 接口。 完成后，调用 IFsiFileItem：：Release 方法来释放接口。

返回值

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

返回代码	说明
E_POINTER	指针无效。 值：0x80004003
IMAPI_E_INVALID_PARAM	提供 的名称 无效。 值：0xC0AAB101
E_OUTOFMEMORY	未能分配所需的内存。 值：0x8007000E

注解

在 IFsiFileItem 接口上设置属性后，对父目录项调用 IFsiDirectoryItem：：Add 方法以将其添加到文件系统映像。

要求

最低受支持的客户端	Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	imapi2fs.h

另请参阅

IFileSystemImage

IFsiFileItem