Rechercher une page de manuel
CoCreateInstance.3w
Langue: en
Version: Jun 2009 (debian - 07/07/09)
Section: 3 (Bibliothèques de fonctions)
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".
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre