Huw Davies : ole32: Remove some useless comments.

[Alexandre Julliard]

Module: wine
Branch: master
Commit: 861bb8ee1355ba0d6649b01fbeaf87818ab4f98a
URL:    http://source.winehq.org/git/wine.git/?a=commit;h=861bb8ee1355ba0d6649b01fbe...

Author: Huw Davies 
Date:   Fri Dec 17 11:51:47 2010 +0000

ole32: Remove some useless comments.

---

dlls/ole32/oleobj.c |   72 +++------------------------------------------------
 1 files changed, 4 insertions(+), 68 deletions(-)

diff --git a/dlls/ole32/oleobj.c b/dlls/ole32/oleobj.c
index 6b4106a..ff77f5b 100644
--- a/dlls/ole32/oleobj.c
+++ b/dlls/ole32/oleobj.c
@@ -274,9 +274,7 @@ static HRESULT WINAPI OleAdviseHolderImpl_QueryInterface(
 {
   OleAdviseHolderImpl *This = (OleAdviseHolderImpl *)iface;
   TRACE("(%p)->(%s,%p)\n",This,debugstr_guid(riid),ppvObj);
-  /*
-   * Sanity check
-   */
+
   if (ppvObj==NULL)
     return E_POINTER;

@@ -284,21 +282,16 @@ static HRESULT WINAPI OleAdviseHolderImpl_QueryInterface(

if (IsEqualIID(riid, &IID_IUnknown))
   {
-    /* IUnknown */
     *ppvObj = This;
   }
   else if(IsEqualIID(riid, &IID_IOleAdviseHolder))
   {
-    /* IOleAdviseHolder */
     *ppvObj = This;
   }

if(*ppvObj == NULL)
     return E_NOINTERFACE;

-  /*
-   * A successful QI always increments the reference count.
-   */
   IUnknown_AddRef((IUnknown*)*ppvObj);

return S_OK;
@@ -348,26 +341,17 @@ static HRESULT WINAPI OleAdviseHolderImpl_Advise(

TRACE("(%p)->(%p, %p)\n", This, pAdvise, pdwConnection);

-  /*
-   * Sanity check
-   */
   if (pdwConnection==NULL)
     return E_POINTER;

*pdwConnection = 0;

-  /*
-   * Find a free spot in the array.
-   */
   for (index = 0; index < This->maxSinks; index++)
   {
     if (This->arrayOfSinks[index]==NULL)
       break;
   }

-  /*
-   * If the array is full, we need to grow it.
-   */
   if (index == This->maxSinks)
   {
     DWORD i;
@@ -383,9 +367,6 @@ static HRESULT WINAPI OleAdviseHolderImpl_Advise(
       This->arrayOfSinks[i]=0;
   }

-  /*
-   * Store the new sink
-   */
   This->arrayOfSinks[index] = pAdvise;

if (This->arrayOfSinks[index]!=NULL)
@@ -651,8 +632,6 @@ static void DataAdviseHolder_Destructor(DataAdviseHolder* ptrToDestroy)

/************************************************************************
  * DataAdviseHolder_QueryInterface (IUnknown)
- *
- * See Windows documentation for more details on IUnknown methods.
  */
 static HRESULT WINAPI DataAdviseHolder_QueryInterface(
   IDataAdviseHolder*      iface,
@@ -661,47 +640,29 @@ static HRESULT WINAPI DataAdviseHolder_QueryInterface(
 {
   DataAdviseHolder *This = (DataAdviseHolder *)iface;
   TRACE("(%p)->(%s,%p)\n",This,debugstr_guid(riid),ppvObject);
-  /*
-   * Perform a sanity check on the parameters.
-   */
+
   if ( (This==0) || (ppvObject==0) )
     return E_INVALIDARG;

-  /*
-   * Initialize the return parameter.
-   */
   *ppvObject = 0;

-  /*
-   * Compare the riid with the interface IDs implemented by this object.
-   */
   if ( IsEqualIID(&IID_IUnknown, riid) ||
        IsEqualIID(&IID_IDataAdviseHolder, riid)  )
   {
     *ppvObject = iface;
   }

-  /*
-   * Check that we obtained an interface.
-   */
   if ((*ppvObject)==0)
   {
     return E_NOINTERFACE;
   }

-  /*
-   * Query Interface always increases the reference count by one when it is
-   * successful.
-   */
   IUnknown_AddRef((IUnknown*)*ppvObject);
-
   return S_OK;
 }

/************************************************************************
  * DataAdviseHolder_AddRef (IUnknown)
- *
- * See Windows documentation for more details on IUnknown methods.
  */
 static ULONG WINAPI       DataAdviseHolder_AddRef(
   IDataAdviseHolder*      iface)
@@ -713,8 +674,6 @@ static ULONG WINAPI       DataAdviseHolder_AddRef(

/************************************************************************
  * DataAdviseHolder_Release (IUnknown)
- *
- * See Windows documentation for more details on IUnknown methods.
  */
 static ULONG WINAPI DataAdviseHolder_Release(
   IDataAdviseHolder*      iface)
@@ -723,14 +682,7 @@ static ULONG WINAPI DataAdviseHolder_Release(
   ULONG ref;
   TRACE("(%p) (ref=%d)\n", This, This->ref);

-  /*
-   * Decrease the reference count on this object.
-   */
   ref = InterlockedDecrement(&This->ref);
-
-  /*
-   * If the reference count goes down to 0, perform suicide.
-   */
   if (ref==0) DataAdviseHolder_Destructor(This);

return ref;
@@ -754,26 +706,18 @@ static HRESULT WINAPI DataAdviseHolder_Advise(

TRACE("(%p)->(%p, %p, %08x, %p, %p)\n", This, pDataObject, pFetc, advf,
    pAdvise, pdwConnection);
-  /*
-   * Sanity check
-   */
+
   if (pdwConnection==NULL)
     return E_POINTER;

*pdwConnection = 0;

-  /*
-   * Find a free spot in the array.
-   */
   for (index = 0; index < This->maxCons; index++)
   {
     if (This->Connections[index].sink == NULL)
       break;
   }

-  /*
-   * If the array is full, we need to grow it.
-   */
   if (index == This->maxCons)
   {
     This->maxCons+=INITIAL_SINKS;
@@ -781,9 +725,7 @@ static HRESULT WINAPI DataAdviseHolder_Advise(
    			    This->Connections,
    			    This->maxCons*sizeof(DataAdviseConnection));
   }
-  /*
-   * Store the new sink
-   */
+
   This->Connections[index].sink = pAdvise;
   This->Connections[index].advf = advf & ~WINE_ADVF_REMOTE;
   This->Connections[index].fmat = *pFetc;
@@ -1010,9 +952,6 @@ HRESULT WINAPI CreateOleAdviseHolder(
 {
   TRACE("(%p)\n", ppOAHolder);

-  /*
-   * Sanity check,
-   */
   if (ppOAHolder==NULL)
     return E_POINTER;

@@ -1032,9 +971,6 @@ HRESULT WINAPI CreateDataAdviseHolder(
 {
   TRACE("(%p)\n", ppDAHolder);

-  /*
-   * Sanity check,
-   */
   if (ppDAHolder==NULL)
     return E_POINTER;