readme.txt

IBM Lotus C++ API 7.0a for IBM Lotus Notes/Domino Directory Release --------- ------------------

Licensed Materials - Property of IBM
C99VCEN

(c) Copyright IBM Corporation 1998, 2007
All rights reserved.
IBM, Lotus, Lotus Notes, Notes, and Domino are trademarks or registered
trademarks of Lotus Development Corporation and/or IBM Corporation
in the United States, or other countries, or both.


PROGRAM
-------
embedole - Sample program that demonstrates embedding an OLE 2 object
           into a note using the C++ API. It also shows how to obtain
           a bitmap from the OLE object and import that bitmap into
           Notes.


ENVIRONMENTS
------------
Sample makefiles are provided for the following environments:

        32-bit Windows


FILES
-----
embedole.cpp - Main program.

msbitmap.c   - Windows bitmap conversion functions

mswin32.mak  - Make file for 32-bit Windows using Microsoft Visual 
               C++.

lincoln.rtf  - Sample file to embed - Lincoln's Gettysburgh Address in
               Microsoft rich text format. 

rtsample.nsf - Sample Notes database (in notedata directory) recommended
               for use with this sample.

readme.txt   - This file.  Specifies what is needed to use this example.


RUNNING embedole
----------------
This sample program will run against any Notes database, but using the
sample database rtsample.nsf is recommended.  The user must supply
command-line parameters to specify:

	* file pathname of object to embed
	* database file pathname
	* (optional) server for the database.

Any OLE object which has an OLE server application installed may be
used.  As a convenience, a sample file lincoln.rtf has been provided.
On most Win32 systems, rich text files are processed by the WordPad
application by default.
(Note: If you are using NT 3.51 this sample will not work since WordPad
is not provided with NT3.51)

- Under Win32:  type 'embedole' at the system command prompt, followed
  by the pathname of the OLE object file, the pathname of the desired
  Notes database, and, optionally, the name of the Notes server.

For example, the sample database rtsample.nsf may be copied to the
user's Notes data directory.  The command line for embedole is:

	embedole lincoln.rtf rtsample.nsf

The program should display:

	Created new document.
	Embedded OLE object from file lincoln.rtf using application WordPad Document
	All Done.  Hit return to exit:


EXAMINING THE NOTES DATABASE TO CHECK THE RESULT
------------------------------------------------
To see if embedole worked correctly:

	Use Notes to open rtsample.nsf
	The database should contain a new document with the title
		"Embedded OLE Object".
	Open the new document.  The bitmap for the embedded OLE object 
		should be displayed.
	Double-click on the embedded object to activate WordPad.