IAttachmentExecute::SetFileName 方法 (shobjidl_core.h)

指定并存储文件的建议名称。

语法

HRESULT SetFileName(
  [in] LPCWSTR pszFileName
);

参数

[in] pszFileName

类型: LPCWSTR

指向包含文件名的字符串的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码,包括以下内容。

返回代码 说明
E_INVALIDARG
pszFileName 值设置为 NULL,指向空字符串,或指向长于 MAX_PATH 的文件名。
E_UNEXPECTED
无法存储文件名。

注解

pszFileName 中不应包含任何路径信息,只需包含文件的名称。

调用应用程序可以使用 IAttachmentExecute::SetFileName 在本地复制文件之前检查文件名的有效性。 检查文件名是否与存储在本地路径位置的其他文件发生名称冲突。

IAttachmentExecute::SetFileName 是可选的。

要求

   
最低受支持的客户端 Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shdocvw.dll (6.0 或更高版本)

另请参阅

IAttachmentExecute

IAttachmentExecute::SetLocalPath