ChangeSet ID: 21191 CVSROOT: /opt/cvs-commit Module name: wine Changes by: julliard@winehq.org 2005/11/09 04:59:11
Modified files: dlls/ole32 : storage32.c storage.c ole2.c ole16.c memlockbytes16.c clipboard.c
Log message: Markus Amsler markus.amsler@oribi.org Improve c2man Documented-Total count.
Patch: http://cvs.winehq.org/patch.py?id=21191
Old revision New revision Changes Path 1.95 1.96 +10 -1 wine/dlls/ole32/storage32.c 1.51 1.52 +6 -1 wine/dlls/ole32/storage.c 1.78 1.79 +8 -6 wine/dlls/ole32/ole2.c 1.23 1.24 +8 -2 wine/dlls/ole32/ole16.c 1.14 1.15 +2 -2 wine/dlls/ole32/memlockbytes16.c 1.46 1.47 +1 -1 wine/dlls/ole32/clipboard.c
Index: wine/dlls/ole32/storage32.c diff -u -p wine/dlls/ole32/storage32.c:1.95 wine/dlls/ole32/storage32.c:1.96 --- wine/dlls/ole32/storage32.c:1.95 9 Nov 2005 10:59:11 -0000 +++ wine/dlls/ole32/storage32.c 9 Nov 2005 10:59:11 -0000 @@ -6140,7 +6140,16 @@ HRESULT WINAPI WriteClassStg(IStorage* p /*********************************************************************** * ReadClassStg (OLE32.@) * - * This method reads the CLSID previously written to a storage object with the WriteClassStg. + * This method reads the CLSID previously written to a storage object with + * the WriteClassStg. + * + * PARAMS + * pstg [I] IStorage pointer + * pclsid [O] Pointer to where the CLSID is written + * + * RETURNS + * Success: S_OK. + * Failure: HRESULT code. */ HRESULT WINAPI ReadClassStg(IStorage *pstg,CLSID *pclsid){
Index: wine/dlls/ole32/storage.c diff -u -p wine/dlls/ole32/storage.c:1.51 wine/dlls/ole32/storage.c:1.52 --- wine/dlls/ole32/storage.c:1.51 9 Nov 2005 10:59:11 -0000 +++ wine/dlls/ole32/storage.c 9 Nov 2005 10:59:11 -0000 @@ -2227,7 +2227,12 @@ HRESULT WINAPI StgOpenStorageOnILockByte * the WriteClassStg. * * PARAMS - * pstg Segmented LPSTORAGE pointer. + * pstg [I] Segmented LPSTORAGE pointer. + * pclsid [O] Pointer to where the CLSID is written + * + * RETURNS + * Success: S_OK. + * Failure: HRESULT code. */ HRESULT WINAPI ReadClassStg16(SEGPTR pstg, CLSID *pclsid) { Index: wine/dlls/ole32/ole2.c diff -u -p wine/dlls/ole32/ole2.c:1.78 wine/dlls/ole32/ole2.c:1.79 --- wine/dlls/ole32/ole2.c:1.78 9 Nov 2005 10:59:11 -0000 +++ wine/dlls/ole32/ole2.c 9 Nov 2005 10:59:11 -0000 @@ -1553,21 +1553,23 @@ HRESULT WINAPI OleDestroyMenuDescriptor(
/*********************************************************************** * OleSetMenuDescriptor [OLE32.@] - * Installs or removes OLE dispatching code for the containers frame window - * FIXME: The lpFrame and lpActiveObject parameters are currently ignored - * OLE should install context sensitive help F1 filtering for the app when - * these are non null. + * Installs or removes OLE dispatching code for the containers frame window. * - * PARAMS: + * PARAMS * hOleMenu Handle to composite menu descriptor * hwndFrame Handle to containers frame window * hwndActiveObject Handle to objects in-place activation window * lpFrame Pointer to IOleInPlaceFrame on containers window * lpActiveObject Pointer to IOleInPlaceActiveObject on active in-place object * - * RETURNS: + * RETURNS * S_OK - menu installed correctly * E_FAIL, E_INVALIDARG, E_UNEXPECTED - failure + * + * FIXME + * The lpFrame and lpActiveObject parameters are currently ignored + * OLE should install context sensitive help F1 filtering for the app when + * these are non null. */ HRESULT WINAPI OleSetMenuDescriptor( HOLEMENU hOleMenu, Index: wine/dlls/ole32/ole16.c diff -u -p wine/dlls/ole32/ole16.c:1.23 wine/dlls/ole32/ole16.c:1.24 --- wine/dlls/ole32/ole16.c:1.23 9 Nov 2005 10:59:11 -0000 +++ wine/dlls/ole32/ole16.c 9 Nov 2005 10:59:11 -0000 @@ -204,6 +204,9 @@ IMalloc16_Constructor()
/*********************************************************************** * CoGetMalloc [COMPOBJ.4] + * + * Retrieve the current win16 IMalloc interface. + * * RETURNS * The current win16 IMalloc */ @@ -344,9 +347,12 @@ HRESULT WINAPI StringFromCLSID16(
/****************************************************************************** * ProgIDFromCLSID [COMPOBJ.62] + * * Converts a class id into the respective Program ID. (By using a registry lookup) - * RETURNS S_OK on success - * riid associated with the progid + * + * RETURNS + * S_OK on success + * riid associated with the progid */ HRESULT WINAPI ProgIDFromCLSID16( REFCLSID clsid, /* [in] class id as found in registry */ Index: wine/dlls/ole32/memlockbytes16.c diff -u -p wine/dlls/ole32/memlockbytes16.c:1.14 wine/dlls/ole32/memlockbytes16.c:1.15 --- wine/dlls/ole32/memlockbytes16.c:1.14 9 Nov 2005 10:59:11 -0000 +++ wine/dlls/ole32/memlockbytes16.c 9 Nov 2005 10:59:11 -0000 @@ -500,12 +500,12 @@ HRESULT HGLOBALLockBytesImpl16_Stat( * * Creates an ILockBytes interface for a HGLOBAL handle. * - * Params: + * PARAMS * hGlobal the global handle (16bit) * fDeleteOnRelease delete handle on release. * ppLkbyt pointer to ILockBytes interface. * - * Returns: + * RETURNS * Staddard OLE error return codes. * */ Index: wine/dlls/ole32/clipboard.c diff -u -p wine/dlls/ole32/clipboard.c:1.46 wine/dlls/ole32/clipboard.c:1.47 --- wine/dlls/ole32/clipboard.c:1.46 9 Nov 2005 10:59:11 -0000 +++ wine/dlls/ole32/clipboard.c 9 Nov 2005 10:59:11 -0000 @@ -303,7 +303,7 @@ typedef struct tagClipboardWindowInfo * Places a pointer to the specified data object onto the clipboard, * making the data object accessible to the OleGetClipboard function. * - * RETURNS: + * RETURNS * * S_OK IDataObject pointer placed on the clipboard * CLIPBRD_E_CANT_OPEN OpenClipboard failed