vtiInsertFile

C++: long vtiInsertFile(LPCTSTR pszPageUrl, LPCTSTR pszWebUrl, LPCTSTR pszFile);

VB: vtiInsertFile(PageUrl as String, WebUrl as string, File as String) as Long

Description

This method inserts the specified file at the insertion point in the specified page. This is equivalent to the FrontPage Editor’s Insert : File command. The type of the file is inferred from the file extension. This method is useful for FrontPage addins which follows these general steps:

1. Addin is invoked from a custom menu command
   
   
2. A dialog is presented to get user input
   
   
3. User presses Ok, and addin generates an output HTML file and inserts it into the page at the insertion point.

Return Value

0 if the file does not exist

1 if the insertion succeeded

Parameters

The typical usage is to pass in the full PageUrl and leave WebUrl empty. But for convenience, you can specify the WebUrl as an absolute URL and the PageUrl as a web-relative URL.

PageUrl is the either the full URL of the page, or a web-relative URL of the page into which you want to insert another file.

WebURL is either NULL (if you specify a full PageUrl) or the URL of the FrontPage web which contains PageUrl.

File is the name of the locally accessible file which you want to insert into the page. That is, it must be a standard file or UNC path reference and not a URL. (e.g. c:\insertme.htm; or \\server\share\thefile.txt)