Metodo IPrintCoreHelper::CreateInstanceOfMSXMLObject (prcomoem.h)

  • Articolo

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 verrà usato per creare l'oggetto.

[in] pUnkOuter

Puntatore all'interfaccia IUnknown dell'oggetto di aggregazione (controllo di 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à usata 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 l'interfaccia IUnknown di controllo 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.

Commenti

IPrintCoreHelper::CreateInstanceOfMSXMLObject consente a un plug-in di usare 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 causa 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.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione prcomoem.h (include Prcomoem.h)