/// <summary>
/// Builds a new <see cref="NativeMethods.RASDIALEXTENSIONS"/> structure based on the component settings.
/// </summary>
/// <returns>A new <see cref="NativeMethods.RASDIALEXTENSIONS"/> structure.</returns>
private NativeMethods.RASDIALEXTENSIONS BuildDialExtensions()
{
NativeMethods.RASDIALEXTENSIONS result = new NativeMethods.RASDIALEXTENSIONS();
result.options = this.GetRasDialOptions();
#if (WIN7 || WIN8)
result.skipPppAuth = this.SkipPppAuthentication;
if (this.AuthenticationCookie != IntPtr.Zero)
{
result.devSpecificInfo = new NativeMethods.RASDEVSPECIFICINFO();
result.devSpecificInfo.cookie = this.AuthenticationCookie;
}
#endif
result.handle = this.Owner != null ? this.Owner.Handle : IntPtr.Zero;
return(result);
}
/// <summary>
/// Performs the dialing operation.
/// </summary>
/// <param name="asynchronous"><b>true</b> if the dialing operation should be asynchronous, otherwise <b>false</b>.</param>
/// <returns>The handle of the connection.</returns>
/// <exception cref="System.InvalidOperationException">A phone number or an entry name with phone book path is required to dial.</exception>
private RasHandle InternalDial(bool asynchronous)
{
if (string.IsNullOrEmpty(this.PhoneNumber) && (string.IsNullOrEmpty(this.EntryName) || string.IsNullOrEmpty(this.PhoneBookPath)))
{
ThrowHelper.ThrowInvalidOperationException(Resources.Exception_PhoneNumberOrEntryNameRequired);
}
lock (this.syncRoot)
{
// NOTE: The synchronization object MUST be locked prior to testing of the component is already busy.
// WARNING! Ensure no exceptions are thrown because existing dial attempts are already in progress. Doing so leaves the
// connection open and cannot be closed if the application is terminated.
if (!this.IsBusy)
{
this.IsBusy = true;
try
{
NativeMethods.RASDIALPARAMS parameters = this.BuildDialParams();
NativeMethods.RASDIALEXTENSIONS extensions = this.BuildDialExtensions();
if (!string.IsNullOrEmpty(this.EntryName))
{
byte[] data = null;
if (this.eapUserData != null)
{
data = this.eapUserData;
}
else
{
data = RasHelper.Default.GetEapUserData(IntPtr.Zero, this.PhoneBookPath, this.EntryName);
}
if (data != null)
{
this.eapDataAddress = Marshal.AllocHGlobal(data.Length);
Marshal.Copy(data, 0, this.eapDataAddress, data.Length);
extensions.eapInfo.eapData = this.eapDataAddress;
extensions.eapInfo.sizeOfEapData = data.Length;
}
}
NativeMethods.RasDialFunc2 callback = null;
if (asynchronous)
{
callback = this.rasDialCallback;
this.asyncOp = AsyncOperationManager.CreateOperation(null);
if (this.timer != null)
{
// Dispose of any existing timer if the component is being reused.
this.timer.Dispose();
this.timer = null;
}
if (this.Timeout != System.Threading.Timeout.Infinite)
{
// A timeout has been requested, create the timer used to handle the connection timeout.
this.timer = new Timer(this.timeoutCallback, null, this.Timeout, System.Threading.Timeout.Infinite);
}
}
this.handle = RasHelper.Default.Dial(this.PhoneBookPath, parameters, extensions, callback, this.GetRasEapOptions());
if (!asynchronous)
{
this.SaveCredentialsToPhoneBook();
this.ReleaseEapIdentity();
// The synchronous dialing operation has completed, reset the dialing flag so the component can be reused.
this.IsBusy = false;
}
}
catch (Exception)
{
// An exception was thrown when the component was attempting to dial a connection. Release the EAP identity and reset the dialing flag so the component can be reused.
this.ReleaseEapIdentity();
this.IsBusy = false;
throw;
}
}
}
return(this.handle);
}
