指定并存储文件的建议名称。
语法
HRESULT SetFileName(
[in] LPCWSTR pszFileName
);
参数
[in] pszFileName
类型： LPCWSTR
指向包含文件名的字符串的指针。
返回值
类型： HRESULT
如果该方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码，包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
pszFileName 值设置为 NULL，指向空字符串，或指向长于 MAX_PATH 的文件名。 |
|
无法存储文件名。 |
注解
pszFileName 中不应包含任何路径信息，只需包含文件的名称。
调用应用程序可以使用 IAttachmentExecute：：SetFileName 在本地复制文件之前检查文件名的有效性。 检查文件名是否与存储在本地路径位置的其他文件发生名称冲突。
IAttachmentExecute：：SetFileName 是可选的。
要求
| 最低受支持的客户端 | Windows XP SP2 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | shobjidl_core.h (包括 Shobjidl.h) |
| DLL | Shdocvw.dll (6.0 或更高版本) |