Reference

CoGetClassObject(3w)

NAME

CoGetClassObject (OLE32.@)

SYNOPSIS

HRESULT CoGetClassObject
(
REFCLSID rclsid,
DWORD dwClsContext,
COSERVERINFO* pServerInfo,
REFIID iid,
LPVOID* ppv
)

DESCRIPTION

Creates an object of the specified class.

PARAMS

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

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

pServerInfo [In] Optional. Details for connecting to a remote server.

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 object.

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.

SEE ALSO

CoCreateInstance()

IMPLEMENTATION

Declared in "objbase.h".

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

Debug channel "ole".

History