IPublishingWizard::Initialize method (shobjidl.h)

Artikel
03/02/2024

Menginisialisasi objek Panduan Penerbitan dengan file yang akan ditransfer, pengaturan yang akan digunakan, dan tipe panduan yang akan dibuat.

Catatan Windows Vista tidak lagi mendukung Panduan Cetak Daring. Namun, metode ini masih dapat digunakan untuk menghasilkan Wizard Tambahkan Tempat Jaringan.

Sintaks

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

Parameter

[in] pdo

Jenis: IDataObject*

Pointer ke instans IDataObject yang mewakili file atau folder yang akan ditransfer, jika pszServiceProvider adalah InternetPhotoPrinting. Jika pszServiceProvider adalah AddNetPlace, parameter ini adalah NULL.

[in] dwOptions

Jenis: DWORD

Kombinasi bendera berikut.

SHPWHF_NORECOMPRESS

Jangan izinkan pemadatan ulang data gambar. Untuk digunakan dengan Panduan Cetak Online.

SHPWHF_NONETPLACECREATE

Jangan membuat pintasan tempat jaringan ketika transfer data selesai. Bendera ini untuk digunakan dengan Panduan Tambahkan Tempat Jaringan.

SHPWHF_NOFILESELECTOR

Jangan perbolehkan pengguna mengubah pilihan file di dalam wizard.

SHPWHF_USEMRU

Tidak didukung.

SHPWHF_ANYLOCATION

Windows Vista dan yang lebih baru. Untuk digunakan dengan Wizard Tambahkan Tempat Jaringan. Jika bendera ini diatur, dan pszServiceProvider adalah AddNetPlace, wizard Tambahkan Tempat Jaringan memperlihatkan opsi untuk memilih lokasi jaringan selain lokasi atau penyedia yang terdaftar untuk muncul di wizard.

SHPWHF_VALIDATEVIAWEBFOLDERS

Untuk digunakan dengan Wizard Tambahkan Tempat Jaringan. Di Windows XP, jika bendera ini diatur dan upaya untuk membuka lokasi jaringan menggunakan WebDAV gagal, Wizard Tambahkan Tempat Jaringan mencoba membuat folder web untuk lokasi tersebut, menggunakan dukungan untuk WEC. Di Windows Vista dan Windows Server 2003, bendera ini tidak berpengaruh dan lokasi jaringan tanpa dukungan untuk WebDAV mungkin tidak dibuka sebagai folder web.

[in] pszServiceScope

Jenis: LPCWSTR

Untai (karakter) Unicode yang menunjukkan jenis wizard yang akan ditampilkan. Nilai peka huruf besar/kecil berikut didukung di Windows Vista.

AddNetPlace

Menginisialisasi Wizard Tambahkan Tempat Jaringan.

InternetPhotoPrinting

Menginisialisasi Panduan Cetak Online. Tidak didukung di Windows Vista.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil atau nilai kesalahan jika tidak, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
E_INVALIDARG	Di Windows Vista, mungkin menunjukkan upaya untuk menginisialisasi Wizard Cetak Online yang tidak didukung dengan meneruskan `InternetPhotoPrinting`pszServiceProvider. Di Windows XP, mungkin menunjukkan bahwa saat menginisialisasi Panduan Cetak Online, parameter pdo adalah NULL atau menunjuk ke pilihan kosong.
E_NOTIMPL	Parameter pszServiceProvider bukan salah satu nilai yang didukung atau parameter dwOptions berisi kombinasi bendera yang tidak didukung.

Keterangan

IPublishingWizard::Initialize, yang diimplementasikan oleh objek Wizard Penerbitan , dipanggil untuk menginisialisasi objek wizard.

Sampel berikut ini tidak berfungsi pada Windows Vista karena Panduan Cetak Online tidak dapat diinstansiasi melalui IPublishingWizard di Windows Vista.

/* 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 tidak benar-benar menampilkan wizard yang diinisialisasi. Lihat topik IPublishingWizard untuk informasi tentang cara menampilkan wizard.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl.h
DLL	Netplwiz.dll

Bagikan melalui