//
// GetLicense is the entry point called by the LicenseManager at design-time,
// build-time, and runtime. It is the only method defined by the
// LicenseProvider base class (though GetKey and IsKeyValid are defined by
// LicFileLicenseProvider, which we derive from).
//
public override License GetLicense(
LicenseContext context,
Type type,
object instance,
bool allowExceptions
)
{
License license;
if (traceSwitch.TraceVerbose)
{
Trace.WriteLine(String.Format("GetLicense({0}, {1})", context.UsageMode, type));
Trace.Indent();
}
//
// Save the instance and context parameters in our fields, since we
// will need their values again in IsKeyValid() and GetKey().
//
this.instance = instance;
this.context = context;
this.licenseComponent = GetLicenseComponent(type, instance);
this.licenseKeyString = null;
if (traceSwitch.TraceVerbose)
{
Trace.WriteLine("Context is of type: " + context.GetType());
Trace.WriteLine("Full name of type is: " + type.AssemblyQualifiedName);
Trace.WriteLine("...and it has GUID: " + type.GUID);
if (this.licenseComponent != null)
{
Trace.WriteLine("License Component found with type: " + this.licenseComponent.GetType().AssemblyQualifiedName);
}
else
{
Trace.WriteLine("License Component was NOT found.");
}
}
//
// Call the base class GetLicense(), which will find the appropriate
// license file or embedded license reference, and subsequently call
// IsKeyValid() and GetKey().
//
license = base.GetLicense(context, type, instance, allowExceptions);
//
// At this point IsKeyValid() and GetKey() have been called.
// If the license object is null, we have an invalid license.
// Handle failures.
//
if (traceSwitch.TraceVerbose)
{
if (license != null)
{
Trace.WriteLine("License was granted.");
Trace.WriteLine(" License: " + license.ToString());
Trace.WriteLine(" License.LicenseKey: " + license.LicenseKey);
}
else
{
Trace.WriteLine("License was NOT granted.");
}
}
if (license == null)
{
//
// Raise the license check failed event. Note that we may
// sometimes have a NULL licenseComponent (for example, if the
// caller used the wrong overload of LicenseManager.Validate()).
//
if (licenseComponent != null)
{
licenseComponent.NotifyLicenseCheckFailed(
licenseCheckFailureReason,
type,
instance,
licenseKeyString
);
}
if (traceSwitch.TraceVerbose)
{
Trace.WriteLine(String.Format("GetLicense: license was not granted. Reason={0}", licenseCheckFailureReason));
Trace.Unindent();
}
return(null);
}
//
// At this point, we have a valid license generated by
// LicFileLicenseProvider. We'll create our own License object
// to return to the caller.
//
LicXLicense l = new LicXLicense(license);
if (traceSwitch.TraceVerbose)
{
Trace.WriteLine(String.Format("GetLicense: license granted. Key={0}", license.LicenseKey));
}
//
// If this is an evaluation license, and we are set up to nag during
// evaluation at runtime, raise the "evaluation license used" event.
//
if (
(context.UsageMode == LicenseUsageMode.Runtime) &&
(l.IsEvaluation) &&
(licenseComponent.NagDuringEvaluation)
)
{
licenseComponent.NotifyEvaluationLicenseUsed(
type,
instance,
l.LicenseKey
);
}
Trace.Unindent();
return(l);
}
