Microsoft KB Archive/165682

= INFO: Visual C++ 5.0 Readme, Documentation Issues =

Article ID: 165682

Article Last Modified on 10/24/2003

-

APPLIES TO


 * Microsoft Visual C++ 5.0 Enterprise Edition
 * Microsoft Visual C++ 5.0 Professional Edition

-



This article was previously published under Q165682



Documentation Issues
Inactive Links in the Online Documentation

Avoid Disc Swapping During Full-Text Search of the Documentation

ODBC 3.0 Programmer's Reference and SDK Guide

Error in the Scribble MDI Drawing Application Documentation

The Properties Menu Item is Now Located on the View Menu

Microsoft Oracle ODBC Driver is Missing from the "ODBC Driver List" Topic

Typographical Error in Circle Tutorial

Documentation Errors in ATL Tutorial

Missing Help Topic for "Ignore Export Library" Check Box

Changes to ATL Stock Property Macros

Changes to the MFC Reference Documentation



Inactive Links in the Online Documentation
Certain types of links in the online documentation do not work. They look like links, but if you click them, nothing happens.

Such inactive links may be due to a setting in your Internet Explorer 3.0 that prevents ActiveX scripts from running.

To enable the links, do the following:


 * 1) Open Internet Explorer 3.0.
 * 2) From the View menu, select Options.
 * 3) In the Options dialog box, click the Security tab.
 * 4) Under Active content, check the Run ActiveX scripts check box.
 * 5) Click Apply.
 * 6) Click OK.

Avoid Disc Swapping During Full-Text Search of the Documentation
The MSDN CD contains all of the online documentation for all products in Visual Studio 97. If you install MSDN and leave it in the CD drive, you will not have to swap discs to search online content.

If you chose the CD-ROM installation option when you installed Visual C++, you will need to have the Visual C++ CD in your CD ROM drive most of the time. To avoid looking for on-line content that is not on the Visual C++ CD, use the Define Subsets command from the Help menu to create a restricted search subset of the following Visual C++ documentation:


 * Welcome to Visual C++ (vcedit)
 * Visual C++ Tutorials (vctutor)
 * Visual C++ Programmer's Guide (vccore)
 * Microsoft Foundation Class Reference (vcmfc)
 * C/C++ Language and C++ Libraries (vclang)
 * Visual C++ Samples (vcsample)

Use this subset when doing most full-text searches. Use the "Entire Contents" subset when you need to search all of the online documentation and don't care about disc swapping.

ODBC 3.0 Programmer's Reference and SDK Guide
The ODBC 3.0 documentation was not available for integration into Visual C++ 5.0 Infoviewer at the time of manufacture. (The ODBC documentation that you can find in the InfoViewer is for ODBC 2.5)

However, the following Windows Help files (WinHlp32.exe) are installed during setup in the DevStudio\SharedIDE\Help directory:


 * ODBC.HLP -- ODBC 3.0 Programmer's Reference
 * SDKGUIDE.HLP -- ODBC 3.0 SDK Guide
 * ODBCJET.HLP -- ODBC Microsoft Desktop Database Drivers Help
 * ODBCJTNW.HLP -- ODBC Desktop Database Drivers - What's New Help

Use the following procedure to add them to the Tools menu:


 * 1) From the Tools menu, click Customize.
 * 2) Click the Tools tab.
 * 3) Scroll to the bottom of the Menu contents grid, add a string to represent launching one of the Help files. For example, type "ODBC 3.0 Programmer's Reference".
 * 4) In the Command edit box, type "WinHlp32.exe".
 * 5) In the Arguments edit box, type the location of ODBC.hlp. For example, type "C:\Program Files\DevStudio\SharedIDE\Help\ODBC.hlp".
 * 6) Click Close.
 * 7) Repeat for each Help file you wish to use.

Error in the Scribble MDI Drawing Application Documentation
In the topic "Create the Dialog Box," in the procedure, "To create the Pen Widths dialog box," Step 3 suggests that you double-click the dialog box to bring up the dialog box property page. To bring up the property page, right- click the dialog box, and then click Properties.

The Properties Menu Item is Now Located on the View Menu
In the topics "Associating the Toolbar Button with a Command ID" and "Adding a Tool Tip" in the Scribble MDI Drawing Application, you are instructed to click Properties from the Edit menu. The Properties item is now located on the View menu.

Microsoft Oracle ODBC Driver is Missing From the "ODBC Driver List" Topic
The list of ODBC drivers, found in the "ODBC Driver List" topic, should include the Microsoft Oracle ODBC driver.

Typographical Error in Circle Tutorial
In the topic "Creating the Basic Control," the first class name in the table that describes the class templates created by ControlWizards is incorrect. The correct class name is CCircApp.   Class      Files        Comments CCircApp  CIRC.H       Implements the main DLL source. CIRC.CPP    Typically, there is no need to modify this code.

Documentation Errors in ATL Tutorial
The ATL Tutorial contains the following two errors:

 Step 4 includes instructions for removing the DllMain entry point. Because the ATL COM AppWizard no longer sets DllMain as the entry point, this step is unnecessary.  In Step 6, the statement: #include Polygon.h should be replaced by   #include "Polygon.h"                        

Missing Help Topic for "Ignore Export Library" Check Box
On the Link tab, General category, when a DLL project (/DLL is one of the link options) is selected in the file tree, there is a new check box, Ignore export library. The context-sensitive Help for this check box is not available. The Help text for the Ignore export library check box is as follows:

When the Ignore export library box is checked, the parent project will not automatically attempt to link to the export library of the subproject. Select this setting when building a resource-only DLL as a subproject of an EXE.

Changes to ATL Stock Property Macros
The macro IMPLEMENT_SMARTPTR_STOCKPROP has been removed from ATL. The macro IMPLEMENT_BOOL_STOCKPROP has been added and should be used for all stock properties that are boolean values, such as the standard AUTOSIZE, BORDERVISIBLE, ENABLED, TABSTOP, and VALID stock properties.

Changes to the MFC Reference Documentation
Three changes to the MFC Reference documentation are included below.

  Details aboutCOleDateTime If you create a COleDateTime object with a date less than 100, the date will be accepted, but subsequent calls to GetYear, GetMonth, GetDay, GetHour, GetMinute, and GetSecond will fail and return -1. Previously, you could use two-digit dates, but dates must be 100 or greater in VC++ 4.2.To avoid problems, specify a four-digit date. For example: COleDateTime.mytime(1996,1,1,0,0,0);  A new override of GetHttpConnection was added: CHttpConnection* GetHttpConnection(LPCTSTR pstrServer, DWORD dwFlags, INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, LPCTSTR pstrUserName = NULL, LPCTSTR pstrPassword = NULL);  The following replacement topic for CInternetSession::OpenURL: CInternetSession::OpenURL

CStdioFile* OpenURL( LPCTSTR pstrURL, DWORD dwContext = 1,

DWORD dwFlags = 0, LPCTSTR pstrHeaders = NULL, DWORD

dwHeadersLength = 0 );

Throw ( CInternetException ); </li></ol>

Return Value

Returns a file handle for FTP, GOPHER, HTTP, and FILE-type Internet services only. Returns NULL if parsing was unsuccessful. The pointer that OpenURL returns depends on pszURL's type of service. The table below illustrates the possible pointers OpenURL can return.

URL type Returns

file://CStdioFile*

http://CHttpFile*

gopher://CGopherFile*

ftp://CInternetFile*

Parameters

pstrURL A pointer to the name of the URL to begin reading. Only URLs beginning with file:, ftp:, gopher:, or http: are supported. ASSERTS if pszURL is NULL.

dwContext An application-defined value passed with the returned handle in callback.

dwFlags The flags describing how to handle this connection. The valid flags, which can be combined with the bitwise OR operator (|), are:


 * INTERNET_FLAG_TRANSFER_ASCII The file is transferred as a text file.
 * INTERNET_FLAG_TRANSFER_BINARY The file is transferred as a binary file.
 * INTERNET_FLAG_RELOAD Get the data from the wire even if it is locally cached.
 * INTERNET_FLAG_DONT_CACHE Do not cache the data, either locally or in any gateways.
 * INTERNET_FLAG_SECURE This flag is applicable to HTTP requests only. It requests secure transactions on the wire with Secure Sockets Layer or PCT.
 * INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT If possible, reuse the existing connections to the server for new requests generated by OpenURL instead of creating a new session for each connection request.
 * INTERNET_FLAG_PASSIVE Used for an FTP site. Uses passive FTP semantics. Used with CInternetConnection of OpenURL.

pstrHeaders A pointer to a string containing the headers to be sent to the HTTP server.

dwHeadersLength The length, in characters, of the additional headers. If this is -1L and pstrHeaders is non-NULL, then pstrHeaders is assumed to be zero terminated and the length is calculated.

Remarks

Call this member function to send the specified request to the HTTP server and allow the client to specify additional RFC822, MIME, or HTTP headers to send along with the request. OpenURL, which wraps the Win32 function InternetOpenURL, allows only downloading, retrieving, and reading the data from an Internet server. OpenURL allows no file manipulation on a remote location, so it requires no CInternetConnection object. To use connection- specific (that is, protocol-specific) functions, such as writing to a file, you must open a session, then open a particular kind of connection, then use that connection to open a file in the desired mode. See CInternetConnection for more information about connection-specific functions.

Keywords: KB165682

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.