IPublishingWizard：：Initialize 方法 (shobjidl.h)

發行項
03/02/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，包括下列專案：

傳回碼	Description
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

共用方式為