vtiPutDocuments

C++: BOOL vtiPutDocuments(LPCTSTR szFileList, LPCTSTR szUrlList);
VB: vtiPutDocuments(FileList as String, UrlList as String) as Integer

Description

This method uploads a list of files from the local file system to the current web, using the authorization established for the FrontPage Explorer’s user when the current web was opened. An error occurs if no web is currently open.

When the documents are uploaded, the FrontPage Server Extensions will expand any FrontPage components in the documents, and regenerate any other documents that depend upon the ones being uploaded. If a URL matches an existing document in the web, a dialog box will appear, giving the user the opportunity to overwrite or preserve the old document.

This method turns off dependency updating in the web during the upload and turns it back

on again when the upload completes. It will block until all files have been uploaded and the server has updated all web dependencies, unless an error occurs during the upload process. Since this method does not update the FrontPage Explorer’s views, in most cases you will want to call vtiRefreshWebFromServer soon afterwards.

Return Value

The return value is true (non-zero) if the call succeeds, and false (zero) if it fails.

Parameters

FileList is a list of absolute paths to files on the local file system. Files can be ASCII or binary. In Visual Basic, you typically place “App.Path” and “\” into a string before adding the name of a file in the current directory. Each file name is separated by a newline character (“\n” in C++, or “CHR$(10)” in Visual Basic). Example: “C:\test\index.htm\nC:\test\logo.gif”.

UrlList is a list of the web-relative URLs where each file in FileList (in the exact same order as in FileList) will be stored in the target web. You can use “8.3” filenames to be safe; otherwise, you’ll need to use vtiGetWebMetaInfo to examine the filename conventions on the web server. The parameter can contain “/”characters to refer to web subdirectories, as long as they exist in the web. Example: “index.htm\nimages/logo.gif”.