IFileSystemImage：：CreateFileItem 方法 (imapi2fs.h)

建立具有指定名稱的檔案專案。

語法

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

參數

[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