Linux Certif

Toute la documentation sur la certification Linux LPI

CoCreateInstance.3w

NAME

CoCreateInstance (OLE32.@)

SYNOPSIS

HRESULT CoCreateInstance
 (
  REFCLSID  rclsid,
  LPUNKNOWN pUnkOuter,
  DWORD     dwClsContext,
  REFIID    iid,
  LPVOID*   ppv
 )

DESCRIPTION

Creates an instance of the specified class.

PARAMS

rclsid [In] Class Id to create an instance of.

pUnkOuter [In] Optional outer unknown to allow aggregation with another object.

dwClsContext [In] Flags to restrict the location of the created instance.

iid [In] The Id of the interface of the instance to return.

ppv [Out] On returns, contains a pointer to the specified interface of the instance.

RETURNS

Success: S_OK

Failure: HRESULT code.

NOTES

The dwClsContext parameter can be one or more of the following:

 CLSCTX_INPROC_SERVER - Use an in-process server, such as from a DLL.

 CLSCTX_INPROC_HANDLER - Use an in-process object which handles certain functions for an object running in another process.

 CLSCTX_LOCAL_SERVER - Connect to an object running in another process.

 CLSCTX_REMOTE_SERVER - Connect to an object running on another machine.

Aggregation is the concept of deferring the IUnknown of an object to another object. This allows a separate object to behave as though it was part of the object and to allow this the pUnkOuter parameter can be set. Note that not all objects support having an outer of unknown.

SEE ALSO

CoGetClassObject()

IMPLEMENTATION

Defined in "objbase.h".

Implemented in "dlls/ole32/compobj.c".

Debug channel "ole".