PRB: L2029 Error when Using the Browser Library
PSS ID Number: Q114589
Article last modified on 06-14-1994

7.00

MS-DOS


----------------------------------------------------------------------
The information in this article applies to:

 - Microsoft C/C++ for MS-DOS, version 7.0
----------------------------------------------------------------------

SYMPTOMS
========

Building a program that uses functions in the C/C++ version 7.0
Browser Library (BSC.LIB) and defines callback functions for the
library may generate the following linker error:

   bsc.lib(printf.c) : error L2029: '_BSCDebugOut' : unresolved
   external

RESOLUTION
==========

This problem can be avoided by defining a dummy function for
BSCDebugOut() as follows:

   VOID BSC_API BSCDebugOut( LSZ lsz ) {¬ }

MORE INFORMATION
================

A callback function is one that performs a particular system service
required by the browser library.  Examples of such services include
memory allocation, file I/O, and error-handling.  The Browser Toolkit
includes BTHUNK?.OBJ files (where ?, C, L, M, or S represents the memory
model).  The BTHUNK?.OBJ files provide default callbacks so that the
browser library does not have to depend on the run-time library for
these services.

The callback functions may be overridden by defining your own
callbacks.  When defining your own callbacks, do not link with the
BTHUNK?.OBJ file.  Instead, provide your own implementations of the
callback functions that the library requires.

For more information on the callbacks functions required by BSC.LIB,
refer to the file BSCREF.TXT supplied with the Browser Toolkit.  BSCREF.TXT
also includes build information.

For more information on overriding functions, refer to the heading How LINK
Resolves References section beginning on page 568 of the "Environment and
Tools" manual.

Refer to Knowledge Base article Q94375 for information on obtaining
the C/C++ version 7.0 Browser Toolkit.

Additional reference words:
KBCategory: Prg
KBSubCategory:

=============================================================================

Copyright Microsoft Corporation 1994.
