CoGetClassObject(3w)

Usage

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

Overview

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.

Implementation

Declared in "objbase.h".

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

Debug channel "ole".

Releases

3 releases since Debian 5.0 (Lenny); the text changed 2 times.