KoCreateInstance function (kcom.h)

This function is intended for internal use only.

The KoCreateInstance function creates an object of the class with the specified CLSID.

Syntax

COMDDKAPI NTSTATUS KoCreateInstance(
  [in]           REFCLSID ClassId,
  [in, optional] IUnknown *UnkOuter,
  [in]           ULONG    ClsContext,
  [in]           REFIID   InterfaceId,
  [out]          PVOID    *Interface
);

Parameters

[in] ClassId

The CLSID of the object to create an instance of.

[in, optional] UnkOuter

The outer unknown object to pass to the new instance.

[in] ClsContext

The context in which to create the instance. This must be CLSCTX_KERNEL_SERVER.

[in] InterfaceId

Reference to the identifier of the interface that will communicate with the object.

[out] Interface

Address of the pointer variable that receives the new interface pointer specified in InterfaceId.

Return value

Returns STATUS_SUCCESS if the instance was successfully created. Otherwise, it returns an error.

Requirements