IClassActivator::GetClassObject

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves a class object. It is similar to CoGetClassObject.

Syntax

HRESULT GetClassObject(
  REFCLSID* pClassID,
  DWORD dwClsContext,
  LCID locale,
  REFIID riid,
  void** ppv 
);

Parameters

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

• dwClsContext
  [in] 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 Value

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.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

See Also

Reference

CoGetClassObject