Contents
Win32 SDK Tools

DDESpy

  About DDESPY

  The Output Menu

  The Monitor Menu

  Tracking Options

WinDiff

  About WinDiff

  WinDiff Command Line

  Expand/Outline Button

  WinDiff Colors

  WinDiff Menus

ZoomIn

  Using ZoomIn

  ZoomIn Menus


Copyright Notice
Copyright Notice for Win32 SDK Tools Help

Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without express written permission of Microsoft Corporation.

© 1993 Microsoft Corporation. All rights reserved.

Microsoft is a registered trademark and Windows and Windows NT are trademarks of Microsoft Corporation.


About WinDiff

The WinDiff utility,graphically compares the contents of two files or two directories. WinDiff allows you to easily compare and modify the contents of files and directories using a graphical Windows interface.


WinDiff Command Line

The full WinDiff command line syntax is:

WINDIFF path1 [path2] [-s [slrd] savefile]

Parameters

path1

Compares files in path1 with files in current directory

path1 path2

Compares files in path1 with files in path2

-slrd

May be any combination of the following options:

-s: Compares files that are the same in both paths.

-l: Compares only files in the first (left-hand) path.

-r: Compares only files in the second (right-hand) path.

-d: Compares two different files in both paths.

savefile

Name of text file to which any or all of the above comparison results are written.


Expand/Outline Button

When chosen, the Expand button displays the contents of the selected file. The button label then changes to Outline. When the Outline button is chosen, it displays only the filename(s). Files with the same name but different contents are displayed in red text. Identical files are displayed in black text.


WinDiff Colors

File contents are displayed in two background colors:

RED

Indicates text from first (left-hand) file.

YELLOW

Indicates text from second (right-hand) file.


WinDiff Menus

File Menu

Compare Files...

Displays the File Open dialog box in which you can enter the names of two files to compare.

Compare Directories...

Displays a dialog box in which you can enter the names of two directories to compare.

Close

Closes the current file(s).

Abort

Terminates a file scanning operation. This menu selection will be unavailable until a scanning operation is initiated.

Save File List...

Displays a dialog box in which you can specify the name of the output file to which the comparison results are written.

Copy Files...

Displays a dialog box in which you can specify files to be moved from one directory to another.

Print

Sends the comparison results to a printer.

Edit Menu

Edit Left File

Displays the contents of the first (left-hand) file using the default Notepad editor.

Edit Right File

Displays the contents of the second (right-hand) file using the default Notepad editor.

Edit Composite File

Displays both files using the default Notepad editor.

Set Editor...

Displays a dialog box in which you can specify the editor to be used for the above operations. By default, Notepad is used.

View Menu

Outline

Shows only the list of filenames (equivalent to the Outline button).

Expand

Shows comparison of the contents of selected files (equivalent to the Expand button).

Picture

Shows a graphical representation of the contents of the two files.

Previous Change

Goes directly to previous area of the file which was changed (if any).

Next Change

Goes directly to next area of the file which was changed (if any).

Expand Menu

Left File Only

Expands only the left-hand file (with changed lines colored appropriately).

Right File Only

Expands only the right-hand file (with changed lines colored appropriately).

Both Files

Expands both files (with changed lines colored appropriately).

Left Line Numbers

Displays line numbers for the first (left-hand) file.

Right Line Numbers

Displays line numbers for the second (right-hand) file.

No Line Numbers

Turns off line number display.

Options Menu

Ignore Blanks

Blank spaces are ignored in the expanded view, so that lines differing only in the amount of white space are shown as identical.

Show Identical Files

In outline view, displays files that are identical.

Show Left-Only Files

In outline view, displays files that appear only in the first (left-hand) path.

Show Right-Only Files

In outline view, displays files that appear only in the second (right-hand) path.

Show Different Files

In outline view, displays files that are in both paths, but are different.

Help Menu

About...

Displays copyright and version information about WinDiff.


About DDESpy

Microsoft Windows NT DDESpy (DDESPY.EXE) is a monitoring tool for the Microsoft Windows NT operating system. DDESpy lets you monitor dynamic data exchange (DDE) activity in the Microsoft Windows NT operating system.

DDESpy is a typical DDE monitoring application. Because DDE is a cooperative activity, DDE monitoring applications must follow certain guidelines for your Windows system to operate properly while they are in use. In particular, DDE monitoring applications should not perform DDE server or client communications  problems may arise when the monitoring application intercepts its own communications.


The Output Menu
The Output Window

DDESpy can display DDE information in a window or on your debugging terminal or can save the displayed information in a file for later use.

You use the Output menu to select where DDESpy is to send output. If you choose the File command, you must specify the name of an output file. After you have chosen the File command once, DDESpy prompts you for an output filename every time you restart the application.

From the Output menu, you can choose to send your output to either a debug terminal or to the DDESpy window. You can also choose the Clear Screen command to clear the display window. Use the Mark command to add text to the display as a marker  for example, before a DDE event to make it easier to find the event in the output file.


The Monitor Menu

You use the Monitor menu to specify one or more types of DDE information that DDESpy is to display. The following information can be displayed:

String handle data

Posted DDE messages

Callbacks

Errors

Filters

The Dynamic Data Exchange protocol passes information by using shared memory. The contents of the shared memory depend on the type of DDE transaction. Several structures have been defined to allow applications using DDE to access the information in shared memory. DDESpy displays the contents of the appropriate structure for the DDE activity being monitored.

You can use the Filters option to choose the type of DDE messages and types of DDE callbacks to monitor.

Monitoring String-Handle Data

The DDE protocol uses the MONHSZSTRUCT structure to pass string-handle data. DDESpy displays the following information from this structure:

Task (application instance)

Time, in milliseconds, since you started Windows

Activity type (create, destroy, or increment)

String handle

String contents

The following example shows a typical DDESpy display of string-handle data:

Task:0x94f, Time:519700, String Handle Created: c4a4(this is a test)

Task:0x94f, Time:526126, String Handle Created: c4aa(another test)

Monitoring Posted DDE Messages

The DDE protocol uses the MONMSGSTRUCT structure to post DDE messages. DDESPY displays the following information from this structure:

Task

Time

Handle of receiving window

Transaction type (sent or posted)

Message type

Handle of sending application

Other message-specific information

The following example shows a typical DDESpy display of DDE message activity:

Task:0x8df Time:642402 hwndTo=0x38dc Message(Sent)=Initiate:

hwndFrom=9224, App=0xc35d("Server")

Topic=*

Task:0x94f Time:642457 hwndTo=0x2408 Message(Sent)=Ack:

hwndFrom=9396, App=0xc35d("Server")status=c35d(fAck fBusy )

Topic=Item=0xc361("System")

Monitoring Callbacks

The DDE protocol uses the MONCBSTRUCT structure to pass information to application callback functions. DDESpy displays the following information from this structure:

Task

Time

Transaction type

Exchanged-data format, if any

Conversation handle

String handles and their referenced strings

Transaction-specific data

The following example shows a typical DDESPY display of callback activity:

Task:0x8df Time:2882628 Callback:

Type=Advstart, fmt=0x1("CF_TEXT"), hConv=0xc24b4,

hsz1=0xc361("System") hsz2=0xc4df("xxcall"), hData=0x0,

lData1=0x83f0000, lData2=0x0

return=0x0

Monitoring Errors

When an error occurs during a DDE transaction, the DDE protocol places the error value and associated information in a MONERRSTRUCT structure. DDESpy uses this structure to display the following information about the error:

Task (the handle of the application that caused the error)

Time

Error value and name


Tracking Options

DDESPY can also display information about aspects of DDE communication in your Windows system:

String handles

Conversations

Links

Services

You can use the Track menu to specify which DDE activity DDESpy is to track. When you choose a command from the Track menu, DDESpy creates a separate window for the display of information in conjunction with the DDE functions. For each window created, DDESpy updates the displayed information as DDE activity occurs. Events that occurred prior to creation of the tracking window are not displayed in the tracking window.

DDESpy can sort the displayed information in the tracking window. If you select the heading for a particular column in the tracking window, DDESpy will sort the displayed information based on the column you selected. This can be useful if you are searching for a particular event or handle.

Tracking String Handles

Windows maintains a system-wide string table containing the string handles that applications use in DDE transactions. To display the system string table so that the string, the string handle, and the string usage count are shown, choose the String Handles command from the Track menu.

Tracking Conversations

To see a display of all active DDE conversations in your Windows system, choose the Conversations command from the Track menu. The Conversations window shows the service name, the current topic, and the server and client handles for each active conversation.

Tracking Links

To see a display of all active DDE advise loops, choose the Links command from the Track menu. The Links window shows the server name, topic, item format, transaction type, client handle, and server handle for every active advise loop in your Windows system.

Tracking Services

Server applications use the DdeNameService function to register with the DDE protocol. When the DDE protocol receives the DdeNameService function call, it adds the server name and an instance-specific name to a list of registered servers. To see a list of registered servers, choose the Services command from the Track menu.


About ZoomIn
Using ZoomIn

The Microsoft ZoomIn utility allows you to capture and enlarge an area of the Windows desktop.

 To use ZoomIn

1.	Double-click its icon in the Microsoft Visual C++ program group.

2.	Resize the ZoomIn window as desired.

2.	Click once with the left mouse button in the ZoomIn window's client area, then drag the rectangle over the target area you want to enlarge.

This target area can be anywhere in the Windows graphical desktop area. The area over which you center the ZoomIn rectangle appears in the ZoomIn window's client area.

3.	Release the mouse button when the desired target area is visible in the ZoomIn window

To enlarge the image, use the scrollbar to scroll down. To reduce the image to its original size, use the scrollbar to scroll up. Each successive mouse click on the scrollbar enlarges or shrinks the image.


ZoomIn Menus

Edit Menu

Copy

Copies the contents of the ZoomIn window to the Windows Clipboard.

Refresh

Updates the image in the ZoomIn window. This update will only be visible if the Windows desktop target area has changed since it was last captured by ZoomIn.

Options Menu

Refresh Rate...

Enables the automatic refresh of the ZoomIn window. This dialog box also allows you to specify, in increments of one-tenth of a second, the automatic refresh interval.

Help Menu

About...

Displays Microsoft ZoomIn version information.