INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES

indexing

project: "Visual Eiffel Win32 Library"
revision: "$Revision: 1.1 $"
copyright: "Copyright (C) 1996-2005 Object Tools Group"
license: "http://visual-eiffel.com/license"
cluster: winlib
class WAPI_COM_FUNCTIONS
feature -- Access

frozen CoInitialize (p: POINTER): INTEGER
-- The `CoInitialize' function initializes the Component Object
-- Model(COM) library. You must initialize the library before you can
-- call its functions. Applications must call `CoInitialize' before
-- they make any other COM library calls except the `CoGetMalloc'
-- function and memory allocation calls.
require
default_pointer: p = default_pointer

frozen CoUninitialize
-- Closes the OLE Component Object Model (COM) library, freeing any
-- resources that it maintains and forcing all RPC connections
-- to close.

frozen OleInitialize (preserved: POINTER): INTEGER
-- The `OleInitialize' function initializes the OLE library. You must
-- initialize the library before you can call OLE functions.
require
default_pointer: preserved = default_pointer

frozen OleUninitialize
-- Closes the OLE library, freeing any resources that it maintains

frozen CoCreateInstance (rclsid: POINTER; punkouter: POINTER; dwclscontext: INTEGER; riid: POINTER; ppv: POINTER): INTEGER
-- Creates a single uninitialized object of the class associated with
-- a specified CLSID. Call CoCreateInstance when you want to create only
-- one object on the local system. To create a single object on a remote
-- system, call CoCreateInstanceEx. To create multiple objects based
-- on a single CLSID, refer to the CoGetClassObject function.

frozen CoGetClassObject (rclsid: POINTER; dwclscontext: INTEGER; pserverinfo: POINTER; riid: POINTER; ppv: POINTER): INTEGER
-- Provides a pointer to an interface on a class object associated with a
-- specified CLSID. CoGetClassObject locates, and if necessary, dynamically
-- loads the executable code required to do this.
-- Call CoGetClassObject directly when you want to create multiple objects
-- through a class object for which there is a CLSID in the system registry.
-- You can also retrieve a class object from a specific remote machine. Most
-- class objects implement the IClassFactory interface. You would then call
-- IClassFactory::CreateInstance to create an uninitialized object. It is
-- not always necessary to go through this process. To create a single
-- object, call instead the either the CoCreateInstanceEx function, which
-- allows you to create an instance on a remote machine. This replaces the
-- CoCreateInstance function, which can still be used to create an instance
-- on a local machine. Both functions encapsulate connecting to the class
-- object, creating the instance, and releasing the class object. Two other
-- functions, CoGetInstanceFromFile and CoGetInstanceFromIStorage, provide
-- both instance creation on a remote system, and object activation. OLE
-- also provides many other ways to create an object in the form of numerous
-- helper functions and interface methods whose function is to create objects
-- of a single type and provide a pointer to an interface on that object.

frozen CoTaskMemAlloc (cb: INTEGER): POINTER
-- Returns LPVOID
-- Allocates a block of task memory in the same way that IMalloc::Alloc does.

frozen CoTaskMemRealloc (pv: POINTER; cb: INTEGER): POINTER
-- Returns LPVOID
-- Changes the size of a previously allocated block of task memory.

frozen CoTaskMemFree (pv: POINTER)
-- Frees a block of task memory previously allocated through a call to
-- the CoTaskMemAlloc or CoTaskMemRealloc function.

frozen CoGetMalloc (dwmemcontext: INTEGER; ppmalloc: POINTER): INTEGER
-- HRESULT
-- Retrieves a pointer to the default OLE task memory allocator (which
-- supports the system implementation of the IMalloc interface) so
-- applications can call its methods to manage memory.

frozen CoRegisterMallocSpy (pmallocspy: POINTER): INTEGER
-- Register an implementation of the IMallocSpy
-- interface in OLE, thereafter requiring OLE to
-- call its wrapper methods around every call to
-- the corresponding IMalloc method. IMallocSpy is
-- defined in OLE to allow developers to debug
-- memory allocations.

frozen CoRevokeMallocSpy: INTEGER
-- Revoke a registered IMallocSpy object
end -- class WAPI_COM_FUNCTIONS

INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES