IPublishingWizard：：Initialize 方法 (shobjidl.h)

  • 项目

使用要传输的文件、要使用的设置和要创建的向导类型初始化 发布 向导对象。

注意 Windows Vista 不再支持联机打印向导。 但是，此方法仍可用于生成“添加网络位置向导”。
 

语法

HRESULT Initialize(
  [in] IDataObject *pdo,
  [in] DWORD       dwOptions,
  [in] LPCWSTR     pszServiceScope
);

参数

[in] pdo

类型： IDataObject*

指向 IDataObject 实例的指针，如果 pszServiceProvider 为 InternetPhotoPrinting，则表示要传输的文件或文件夹。 如果 pszServiceProvider 为 AddNetPlace，则此参数为 NULL。

[in] dwOptions

类型：DWORD

以下标志的组合。

SHPWHF_NORECOMPRESS

不允许重新压缩图像数据。 用于联机打印向导。

SHPWHF_NONETPLACECREATE

数据传输完成后，请勿创建网络位置快捷方式。 此标志用于添加网络位置向导。

SHPWHF_NOFILESELECTOR

不允许用户在向导中更改文件选择。

SHPWHF_USEMRU

不支持。

SHPWHF_ANYLOCATION

Windows Vista 及更高版本。 用于添加网络位置向导。 如果设置了此标志，并且 pszServiceProvider 为 AddNetPlace，则“添加网络位置”向导会显示一个选项，用于选择一个网络位置，而不是要显示在向导中注册的位置或提供程序。

SHPWHF_VALIDATEVIAWEBFOLDERS

用于添加网络位置向导。 在 Windows XP 中，如果设置了此标志，并且尝试使用 WebDAV 打开网络位置失败，则添加网络位置向导会尝试使用 WEC 支持为该位置创建 Web 文件夹。 在 Windows Vista 和 Windows Server 2003 中，此标志不起作用，并且不支持 WebDAV 的网络位置可能无法作为 Web 文件夹打开。

[in] pszServiceScope

类型： LPCWSTR

指示要显示的向导类型的 Unicode 字符串。 Windows Vista 支持以下区分大小写的值。

AddNetPlace

初始化“添加网络位置向导”。

InternetPhotoPrinting

初始化联机打印向导。 在 Windows Vista 中不受支持。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值，包括以下内容：

返回代码 说明
E_INVALIDARG
 在 Windows Vista 中， 可能指示尝试通过传入 InternetPhotoPrintingpszServiceProvider 初始化不受支持的联机打印向导。

在 Windows XP 中， 可能指示在初始化联机打印向导时， pdo 参数为 NULL 或指向空选择。
E_NOTIMPL
 pszServiceProvider 参数不是支持的值之一，或者 dwOptions 参数包含不受支持的标志组合。

注解

调用由发布向导对象实现的 IPublishingWizard：：Initialize 来初始化向导对象。

以下示例在 Windows Vista 上不起作用，因为无法通过 Windows Vista 中的 IPublishingWizard 实例化联机打印向导。

/* initializing the Online Print Wizard in Windows XP or Windows 2003 Server*/
hr = pPublish->Initialize(pDataObject,  // A data object that represents files or 
                                        // folders to transfer.
                          SHPWHF_NOFILESELECTOR,     // Flags
                          L"InternetPhotoPrinting"); // Display the Online Print Wizard.

IPublishingWizard：：Initialize 实际上不显示初始化的向导。 有关如何显示向导的信息，请参阅 IPublishingWizard 主题。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl.h
DLL Netplwiz.dll