Metodo IPrintCoreHelper::CreateInstanceOfMSXMLObject (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintCoreHelper::CreateInstanceOfMSXMLObject crea un'istanza di un oggetto MSXML 6.0 usando la DLL MSXML corretta.

Sintassi

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

Parametri

[in] rclsid

CLSID associato ai dati e al codice che verranno usati per creare l'oggetto.

[in] pUnkOuter

Puntatore all'interfaccia di IUnknown dell'oggetto aggregato (il controllo IUnknown). Questo parametro deve essere NULL, il che significa che l'oggetto non viene creato come parte di un'aggregazione.

[in] dwClsContext

Contesto in cui verrà eseguito il codice che gestisce l'oggetto appena creato. Gli unici valori validi sono NULL e CLSCTX_INPROC_SERVER, ovvero un valore dell'enumerazione CLSCTX (descritta nella documentazione di Microsoft Windows SDK).

[in] riid

Riferimento all'identificatore dell'interfaccia che verrà utilizzata per comunicare con l'oggetto .

[out] ppv

Puntatore a una variabile che riceve l'indirizzo dell'interfaccia richiesta nel parametro riid. Se IPrintCoreHelper::CreateInstanceOfMSXMLObject restituisce correttamente, * ppv contiene l'indirizzo dell'interfaccia richiesta. Se questo metodo ha esito negativo, * ppv contiene NULL.

Valore restituito

IPrintCoreHelper::CreateInstanceOfMSXMLObject deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	È stata creata correttamente un'istanza della classe oggetto specificata.
CLASS_E_NOAGGREGATION	Impossibile creare la classe specificata come parte di un'aggregazione.
E_NOINTERFACE	La classe specificata non implementa l'interfaccia richiesta o il controllo 'interfaccia IUnknown non espone l'interfaccia richiesta.
REGDB_E_CLASSNOTREG	Una classe specificata non è registrata nel database di registrazione. Questo valore può anche indicare che il tipo di server richiesto nel tipo di enumerazione CLSCTX non è registrato o i valori per i tipi di server nel Registro di sistema sono danneggiati.

Osservazioni

IPrintCoreHelper::CreateInstanceOfMSXMLObject consente a un plug-in di usare gli oggetti MSXML in modo sicuro anche quando viene eseguito su computer client di livello inferiore, ovvero computer client che eseguono Windows Server 2003, Windows XP o Windows 2000.

I parametri in questo metodo vengono mappati direttamente a quelli della funzione CoCreateInstance (descritta nella documentazione di Windows SDK). Si noti che l'installazione di un driver Windows Vista in un computer che esegue una versione precedente di Windows non comporta l'installazione di MSXML 6.0. La DLL effettiva è inclusa nelle DLL dipendenti dal driver e viene caricata dalla directory del driver. Non è registrato nel sistema. I plug-in che usano questo metodo devono creare solo oggetti MSXML.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Condividi tramite