IClassActivator::GetClassObject

Retrieves a class object. Similar to CoGetClassObject.

HRESULT GetClassObject(
  REFCLSID *pClassID,  //CLSID of class object desired
  DWORD dwClsContext,  //Values from CLSCTX
  LCID locale,         //LCID constant
  REFIID riid,         //IID of requested interface
  void ** ppv          //Address of output variable that receives 
                       // the interface pointer requested in riid
);
 

Parameter

pClassID

[in] Points to the CLSID that Identifies the class whose class object is to be retrieved.

dwClsContext

[in] The context in which the class is expected to run; values are taken from the CLSCTX enumeration.

locale

[in] Any LCID constant as defined in WINNLS.H.

riid

[in] IID of the interface on the object to which a pointer is desired.

ppv

[out] Address of pointer variable that receives the interface pointer requested in riid. Upon successful return, *ppv contains the requested interface pointer.

Return Values

This method supports the standard return value E_FAIL, as well as the following:

S_OK

The CLSID was successfully returned.

Remarks

This method returns the class identifier (CLSID) for an object, used in later operations to load object-specific code into the caller's context.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.

See Also

CoGetClassObject