IPublishingWizard：：Initialize 方法 (shobjidl.h)

项目
03/05/2024

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

注意 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 中，可能指示尝试通过传入 `InternetPhotoPrinting`pszServiceProvider 初始化不受支持的联机打印向导。在 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

通过