User Guide

The Design Notes C API 51
Returns
A Boolean value: true indicates the operation is successful; false otherwise. The
drivePathBuf argument receives the local drive path.
FileHandle OpenNotesFile()
Description
This function opens the Design Notes file that is associated with the specified file or creates
one if none exists.
Arguments
const char* localFileURL, {BOOL bForceCreate}
■ The localFileURL argument, which is expressed as a file:// URL, is a string that contains
the path to the main file with which the Design Notes file is associated.
■ The bForceCreate argument is a Boolean value that indicates whether to create the
Design Notes file even if Design Notes is turned off for the site or if the path specified by
the
localFileURL argument is not associated with any site.
FileHandle OpenNotesFilewithOpenFlags()
Description
This function opens the Design Notes file that is associated with the specified file or creates
one if none exists. You can open the file in read-only mode.
Arguments
const char* localFileURL, {BOOL bForceCreate}, {BOOL bReadOnly}
■ The localFileURL argument, which is expressed as a file:// URL, is a string that contains
the path to the main file with which the Design Notes file is associated.
■ The bForceCreate argument is a Boolean value that indicates whether to create the
Design Notes file even if Design Notes are turned off for the site or the path is not
associated with any site. The default value is
false. This argument is optional, but you
need to specify it if you specify the third argument.
■ The bReadOnly argument, which is optional, is a Boolean value that indicates whether to
open the file in read-only mode. The default value is
false. You can specify the
bReadOnly argument starting in version 2 of the MMNotes.dll file.
000_DW_API_Print.book Page 51 Wednesday, July 20, 2005 11:58 AM