IPreviewHandler::D oPreview 方法 (shobjidl_core.h)

指示预览处理程序从先前的 Initialize 方法调用中指定的源加载数据,并开始呈现到预览器窗口。

语法

HRESULT DoPreview();

返回值

类型: HRESULT

此方法可以返回其中一个值。

返回代码 说明
S_OK
操作已成功完成。
E_PREVIEWHANDLER_DRM_FAIL
被数字版权管理阻止。
E_PREVIEWHANDLER_NOAUTH
被文件权限阻止。
E_PREVIEWHANDLER_NOTFOUND
找不到项。
E_PREVIEWHANDLER_CORRUPT
项目已损坏。

注解

如果尚未创建预览器窗口,则必须在调用此方法后创建它。 预览处理程序负责绘制 IPreviewHandler::SetWindowIPreviewHandler::SetRect 中指定的区域。 如果在预览处理程序呈现时调用这些方法,则必须重设窗口的父级/调整其大小,而不停止或重启项的呈现。

只有在调用 了 IPreviewHandler::SetWindow 之后,才应调用此方法。

此外,只有在调用 Initialize、InitializeInitialize 之后,才应调用此方法。

注意 在调用此方法之前,请勿实际创建预览器窗口。
 

要求

要求
最低受支持的客户端 Windows Vista、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
可再发行组件 Windows Search 4 或更高版本