IPublishingWizard：：Initialize 方法 (shobjidl.h)

使用要傳送的檔案、要使用的設定，以及要建立的精靈類型，初始化 發行精靈 物件。

語法

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，包括下列專案：

備註

呼叫發行精靈物件所實作的 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 主題。

規格需求