Metode IPrintCoreHelperPS::CreateInstanceOfMSXMLObject (prcomoem.h)

Artikel
02/29/2024

Metode IPrintCoreHelperPS::CreateInstanceOfMSXMLObject membuat instans objek MSXML.

Sintaks

HRESULT CreateInstanceOfMSXMLObject(
  [in]  IN REFCLSID  rclsid,
  [in]  IN LPUNKNOWN pUnkOuter,
  [in]  IN DWORD     dwClsContext,
  [in]  IN REFIID    riid,
  [out] OUT LPVOID   *ppv
);

Parameter

[in] rclsid

CLSID yang terkait dengan data dan kode yang akan digunakan untuk membuat objek.

[in] pUnkOuter

Penunjuk ke antarmuka IUnknown objek agregat ( IUnknown pengontrol). Parameter ini harus NULL, yang berarti bahwa objek tidak dibuat sebagai bagian dari agregat.

[in] dwClsContext

Konteks di mana kode yang mengelola objek yang baru dibuat akan berjalan. Satu-satunya nilai yang valid adalah NULL dan CLSCTX_INPROC_SERVER, yang merupakan nilai enumerasi CLSCTX (dijelaskan dalam dokumentasi Microsoft Windows SDK).

[in] riid

Referensi ke pengidentifikasi antarmuka yang akan digunakan untuk berkomunikasi dengan objek.

[out] ppv

Pointer ke alamat memori yang menerima alamat antarmuka yang diminta dalam parameter riid . Jika IPrintCoreHelperPS::CreateInstanceOfMSXMLObject berhasil dikembalikan, *ppv berisi alamat antarmuka yang diminta. Jika metode ini gagal, *ppv berisi NULL.

Nilai kembali

IPrintCoreHelperPS::CreateInstanceOfMSXMLObject harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Instans kelas objek yang ditentukan berhasil dibuat.
CLASS_E_NOAGGREGATION	Kelas yang ditentukan tidak dapat dibuat sebagai bagian dari agregat.
E_NOINTERFACE	Kelas yang ditentukan tidak mengimplementasikan antarmuka yang diminta, atau antarmuka IUnknown yang mengontrol tidak mengekspos antarmuka yang diminta.
REGDB_E_CLASSNOTREG	Kelas yang ditentukan tidak terdaftar dalam database pendaftaran. Nilai ini juga dapat menunjukkan bahwa jenis server yang Anda minta dalam jenis enumerasi CLSCTX tidak terdaftar atau nilai untuk jenis server di registri rusak.

Keterangan

Plug-in tidak boleh langsung membuat objek MSXML dengan memanggil CoCreateInstance (dijelaskan dalam dokumentasi Windows SDK). Sebaliknya, ia harus memanggil Pscript untuk melakukannya. Alasannya adalah bahwa dalam kondisi tertentu di mana driver printer dapat digunakan, seperti dengan versi sistem operasi yang lebih lama, sistem operasi tidak perlu mendaftarkan versi MSXML yang diperlukan, yang saat ini adalah versi 6. Dalam situasi seperti itu, memanggil CoCreateInstance dapat gagal. Namun, driver inti memastikan bahwa di mana pun driver ada, DLL pengurai MSXML juga ada di komputer, sehingga memungkinkan untuk membuat objek MSXML saat diperlukan.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	prcomoem.h (termasuk Prcomoem.h)

Bagikan melalui