HostConnectDrive Method (IntPtr, String, String, String, String, Boolean, Boolean, Boolean) |
Creates a connection to a network resource. The function can redirect a local device to a network resource.
Namespace:
Alphaleonis.Win32.Network
Assembly:
AlphaFS (in AlphaFS.dll) Version: 2.0
Syntax public static string ConnectDrive(
IntPtr winOwner,
string localName,
string remoteName,
string userName,
string password,
bool prompt,
bool updateProfile,
bool saveCredentials
)
Public Shared Function ConnectDrive (
winOwner As IntPtr,
localName As String,
remoteName As String,
userName As String,
password As String,
prompt As Boolean,
updateProfile As Boolean,
saveCredentials As Boolean
) As String
public:
static String^ ConnectDrive(
IntPtr winOwner,
String^ localName,
String^ remoteName,
String^ userName,
String^ password,
bool prompt,
bool updateProfile,
bool saveCredentials
)
static member ConnectDrive :
winOwner : IntPtr *
localName : string *
remoteName : string *
userName : string *
password : string *
prompt : bool *
updateProfile : bool *
saveCredentials : bool -> string
Parameters
- winOwner
- Type: SystemIntPtr
Handle to a window that the provider of network resources can use as an owner window for dialog boxes. - localName
- Type: SystemString
The name of a local device to be redirected, such as "F:". When localName is or
string.Empty, the last available drive letter will be used. Letters are assigned beginning with Z:, then Y: and so on.
- remoteName
- Type: SystemString
The network resource to connect to. The string can be up to MAX_PATH characters in length. - userName
- Type: SystemString
The user name for making the connection. If userName is , the function uses the default
user name. (The user context for the process provides the default user name)
- password
- Type: SystemString
The password to be used for making the network connection. If password is , the function
uses the current default password associated with the user specified by userName.
- prompt
- Type: SystemBoolean
always pops-up an authentication dialog box. - updateProfile
- Type: SystemBoolean
successful network resource connections will be saved. - saveCredentials
- Type: SystemBoolean
When the operating system prompts for a credential, the credential should be saved by the credential manager when true.
Return Value
Type:
StringIf
localName is
or
string.Empty, returns the last available drive letter, null otherwise.
See Also