Microsoft KB Archive/105042

= How To Add/Remove Network Connections in FoxPro =

Article ID: 105042

Article Last Modified on 6/29/2004

-

APPLIES TO


 * Microsoft Visual FoxPro 3.0 Standard Edition
 * Microsoft Visual FoxPro 5.0 Standard Edition

-



This article was previously published under Q105042



SUMMARY
You can add and remove network connections from within a FoxPro for Windows application by using the Windows application programming interface (API) through FOXTOOLS.FLL, a library file included with FoxPro. To do this, see below.

NOTE: For backward compatibility, Visual FoxPro still supports FOXTOOLS.FLL (included in earlier FoxPro versions), the Visual FoxPro API library that allows calls to 16-bit .DLL functions. However, in Visual FoxPro, the DECLARE command is the preferred method for calling .DLL functions.



MORE INFORMATION
  In a program, you must open the FOXTOOLS.FLL external library first. To do this, use the SET LIBRARY TO command as follows to ensure that the program finds the FOXTOOLS.FLL library in the FoxPro directory: SET LIBRARY TO SYS(2004)+'FOXTOOLS.FLL' ADDITIVE   Register the Windows API functions that you would like to call. In this case, use WNetAddConnection and WNetCancelConnection. addconn=RegFn('WNetAddConnection','CCC','I') delconn=RegFn('WNetCancelConnection','CI','I')   To make a connection to a network device, issue the following command: =CallFn(addconn,"\\SERVER\SHARE","password"," :")   To disconnect a network connection, issue the following command: =CallFn(delconn," :",0) 

WNetAddConnection
The WNetAddConnection function redirects the specified local device (either a disk drive or a printer port) to the given shared device or remote server. It takes the following parameters:   Parameter         Description ---

lpszNetPathName  A pointer to a null-terminated string specifying the shared device or remote server, such as                    \\SERVER\SHARE. NOTE: Novell users should not use the double-colon syntax to reference a server and directory, as they may be accustomed to doing. For example, do not try referencing a directory using the following syntax:   \\server\volume::\mydirectory Instead use this syntax: \\server\volume\mydirectory   lpszPassword      A pointer to a null-terminated string specifying the network password for the given device or                    server. If there is no password, you must still include a placeholder, as follows:

=CallFn(addconn,"\\SERVER\SHARE",""," :")

lpszLocalName    A pointer to a null-terminated string specifying the local drive or device to be redirected. All lpszLocalName strings (such as LPT1) are case-independent. Only the drive names A through Z and the device names LPT1 through LPT3 are used.

WNetCancelConnection
The WNetCancelConnection function cancels a network connection. It takes the following parameters: <pre class="fixed_text">  Parameter         Description ---

lpszName         A pointer to the name of the redirected local device (such as LPT1: or D:).

fForce           A Boolean value that specifies whether any open files or open print jobs on the device should be                    closed before the connection is canceled.

<div class="references_section">