INFO: Dynamically Add UserControls That Require Run-Time Licenses (241126)


The information in this article applies to:

  • Microsoft Visual Basic Professional Edition for Windows 6.0
  • Microsoft Visual Basic Enterprise Edition for Windows 6.0
This article was previously published under Q241126

SUMMARY

When a UserControl contains one or more controls that require run-time licenses, the UserControl implicitly becomes a licensed control (requires run-time license). As a result, when you use the Controls.Add method to add the UserControl dynamically, you must precede it by a call to the Licenses.Add method and provide the license key for the call.

MORE INFORMATION

If you create a UserControl named, for example, MyProject.MyUserControl, that contains one or more controls that require a run-time license, MyProject.MyUserControl acquires a run-time license implicitly. Therefore, if you use the Controls.Add method to add MyProject.MyUserControl dynamically, or call Licenses.Add "MyProject.MyUserControl" without providing the license key, you get the following error message:
Run-time error '429': You do not have an appropriate license to use this functionality.
To make this work, you must obtain MyProject.MyUserControl's license key on the development computer with the following code: 
Debug.Print Licenses.Add ("MyProject.MyUserControl")
Then, in the client code, you can use the following code to dynamically add MyProject.MyUserControl: 
Licenses.Add "MyProject.MyUserControl", "License Key"<BR/>
Form1.Controls.Add "MyProject.MyUserControl", "ControlName"

REFERENCES

For additional information how to add controls dynamically, click the article number below to view the article in the Microsoft Knowledge Base:

190670 HOWTO: Dynamically Add Controls to a Form with Visual Basic 6.0

Modification Type:MajorLast Reviewed:1/11/2001
Keywords:kbCtrl kbDSupport kbinfo kbLicensing KB241126
©2002 Microsoft Corporation. All rights reserved.