SAMPLE: Wsscanf.exe Replaces sscanf in Windows DLLs (76684)



The information in this article applies to:

  • Microsoft Windows Software Development Kit (SDK) 3.0
  • Microsoft Windows Software Development Kit (SDK) 3.1

This article was previously published under Q76684

SUMMARY

Wsscanf.exe that can serve as a limited replacement for the Microsoft C run- time library function sscanf, which is not compatible for use with a dynamic-link library (DLL) for the Microsoft Windows graphical environment.

MORE INFORMATION

The following file is available for download from the Microsoft Download Center:
For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

The sscanf(), fprintf(), and scanf() functions are not available for Windows DLLs.

There are two factors that cause these functions to be incompatible:

  1. These functions rely on near pointers.
  2. These functions expect SS == DS.
Because neither of these conditions is true when a function in a DLL uses data from an application, these functions are not available.

The WSSCANF file in the Microsoft Download Center contains the source code to a wsscanf() function that can serve as a limited replacement for the sscanf function. It does not support floating point. The wsscanf() code is based on the sscanf() source code in the Microsoft C 6.0a run-time library. The source code has been modified to work correctly in a DLL, and requires that all parameters are specified as FAR pointers. The following code demonstrates using the wsscanf() function:
    char   szBuf[] = "1 3 b000:0200";
   int    nValue1, nValue2;
   LPSTR  lpPtr;

   wsscanf(szBuf, "%d %d %p", (int FAR *)&nValue1,
            (int FAR *)&nValue2, (LPSTR FAR *)&lpPtr);
				
NOTE: The first two parameters are not explicitly typecast in the function call. The function prototype typecasts the first two parameters automatically; however, the application must typecast each subsequent parameter. If the application does not typecast each parameter, when the application calls wsscanf an unrecoverable application error (UAE) occurs.

The wsscanf() function does not support floating point numbers (the %f, %g, and %e format specifiers).

Modification Type:MinorLast Reviewed:8/30/2004
Keywords:kb16bitonly kbfile kbSample KB76684