Edit

Share via

IPrintCoreHelperUni::CreateInstanceOfMSXMLObject method (prcomoem.h)

  • Article

The IPrintCoreHelperUni::CreateInstanceOfMSXMLObject method creates an instance of an MSXML object.

Syntax

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

Parameters

[in] rclsid

The CLSID that is associated with the data and code that will be used to create the object.

[in] pUnkOuter

A pointer to the aggregate object's IUnknown interface (the controlling IUnknown). This parameter must be NULL, which means that the object is not being created as part of an aggregate.

[in] dwClsContext

The context in which the code that manages the newly created object will run. The only valid values are NULL and CLSCTX_INPROC_SERVER, which is a value of the CLSCTX enumeration (described in the Microsoft Windows SDK documentation).

[in] riid

A reference to the identifier of the interface that will be used to communicate with the object.

[out] ppv

A pointer to a memory address that receives the address of the interface that is requested in the riid parameter. If IPrintCoreHelperUni::CreateInstanceOfMSXMLObject successfully returns, *ppv contains the address of the requested interface. If this method fails, *ppv contains NULL.

Return value

IPrintCoreHelperUni::CreateInstanceOfMSXMLObject should return one of the following values.

Return code Description
S_OK
 An instance of the specified object class was successfully created.
CLASS_E_NOAGGREGATION
 The specified class cannot be created as part of an aggregate.
E_NOINTERFACE
 The specified class does not implement the requested interface, or the controlling IUnknown interface does not expose the requested interface.
REGDB_E_CLASSNOTREG
 A specified class is not registered in the registration database. This value can also indicate that the type of server you requested in the CLSCTX enumeration type is not registered or the values for the server types in the registry are corrupt.

Requirements

Requirement Value
Target Platform Desktop
Header prcomoem.h (include Prcomoem.h)