Microsoft KB Archive/166287

From BetaArchive Wiki
Knowledge Base


Article ID: 166287

Article Last Modified on 10/12/2007



APPLIES TO

  • Microsoft Excel 97 Standard Edition
  • Microsoft Excel Software Development Kit 5.0



This article was previously published under Q166287

SYMPTOMS

When you use XlCoerce in a dynamic-link library (DLL) that is loaded by Microsoft Excel 97, the following error message appears

Unhandled exception in excel.exe (MSO97.DLL): 0xc0000005: Access Violation

and Microsoft Excel stops responding.

CAUSE

This problem occurs when the following conditions are true:

  • You are using Microsoft Excel 97.
  • The DLL function is called from a worksheet as a result of a calculation.
  • You are trying to use XlCoerce to coerce a reference XLOPER that refers to a range that contains text.


RESOLUTION

To correct this problem, install Microsoft Excel 97 Service Release 1 (SR- 1).

To temporarily work around this problem, use one of the following methods.

Method 1

If XLOPER does not reference any cells that contain text, use the following function to determine whether to use XlCoerce:

        /*********
      *  RangeContainsText
      *
      *  Purpose: Determine if a XLOPER reference points to a range that
      *           contains any cells containing text.  Microsoft Excel 97
      *           stops responding if XlCoerce is used to convert a
      *           reference to a string.
      *
      *  Parameter:
      *           pxRange[in]    Range to check.
      *
      *  Return:  TRUE  -  Range contains text, or Excel4 call fails.
      *           FALSE -  Range does not contain text and it is safe to
      *                    use XlCoerce on the reference as a workaround
      *                    to the problem.
      *
      *******************************************************************/ 
      BOOL RangeContainsText(LPXLOPER pxRange)
      {
         DWORD dwRet = 0;
         XLOPER xIsText;
         BOOL bRet = TRUE;  // Value returned if Excel4 Fails

         // Check determine whether you are working with a range
         if( !((xltypeSRef | xltypeRef) & (pxRange->xltype)))
            return bRet;

         dwRet = Excel4(xlfIstext,&xIsText,1,pxRange);
         if( xlretSuccess == dwRet && xltypeErr != xIsText.xltype)
         {
            XLOPER xRet;
            dwRet = Excel4(xlfOr,&xRet,1,&xIsText);
            if( xlretSuccess == dwRet && xltypeBool == xRet.xltype)
               bRet = xRet.val.bool;
         }
         Excel4(xlFree,0,1,&xIsText);
         return bRet;
      }
                

Method 2

Instead of using the R data type to pass a range or a cell that may contain text, use the OPER data type (P). This data type does not support references, but it does support arrays, numbers, Boolean values, and errors. For more information about the Register function, see the Microsoft

Excel Software Development Kit (SDK).

STATUS

Microsoft has confirmed this to be a problem in Microsoft Excel 97 for Windows. This problem was corrected in Microsoft Excel 97 SR-1.

For more information about SR-1, click the following article number to view the article in the Microsoft Knowledge Base:

172475 How to obtain and install Microsoft Office 97 SR-1



Additional query words: sr1 crash 97 xldk xlsdk Excel4 Excel FIX

Keywords: kbbug kbdtacode kberrmsg kbfix kbprogramming KB166287