IWPSiteW::PostFiles Method

Posts files to the specified URL on the destination site identified by this object.

Syntax

HRESULT PostFiles(
    DWORD cLocalPaths,
    LPWSTR *pwsLocalPaths,
    LPDWORD pdwURLBufLen,
    LPWSTR wsURL,
    DWORD fdwFlags
);

Parameters

cLocalPaths
Number of elements in the pwsLocalPaths array.

pwsLocalPaths
Address of an array of null-terminated strings that contain the file names or directories to be posted on the Internet. If any of these strings point to a directory and the WPF_NO_RECURSIVE_POST flag is not set in fdwFlags, all the files in that directory are posted.

pdwURLBufLen
Address of a variable that indicates the length of the wsURL buffer. When the function returns, the variable contains the length, in bytes, of the that buffer.

wsURL
Optional. Address of a null-terminated string that contains the destination URL. If this parameter is NULL, the files are posted in the root URL for the site.

If this parameter is not NULL, the URL of the copied file, or the URL of the directory that the files were copied to, is returned in the buffer pointed to by this parameter.

fdwFlags
Action flags.

WPF_NO_RECURSIVE_POST
If any element in the pwsLocalPaths array points to a directory, do not post files recursively.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

Changes for version 1.5:

Service providers are no longer required to support the posting of multiple files. It is not a violation of the interface contract for a service provider to return failure if cLocalPaths is greater than 1.

If a callback function has been specified to the service provider with a previous call into SetProgressUpdateProc, the service provider should call the callback function while posting. See the description of SetProgressUpdateProc for more information.