MSFT_TemplateBuilder class
The MSFT_TemplateBuilder class specifies a low-level object that is created when the user creates an instance of a template object. An instance of a template builder is created for each low-level object needed by the template class.
Note For more information about support and installation of this component on a specific operating system, see Operating System Availability of WMI Components.
Syntax
class MSFT_TemplateBuilder
{
string ControllingProperty;
string Name;
string NamespaceProperty;
sint32 Order = 0;
object Target;
string Template;
};
Members
The MSFT_TemplateBuilder class has these types of members:
- Properties
Properties
The MSFT_TemplateBuilder class has these properties.
ControllingProperty
Data type: string
Access type: Read/write
Option that makes the creation of a template builder object dependent on a template property value. If specified, the template provider observes, when the template object is created, the template argument named by the property. If the value of this property is NULL or if the property is a Boolean type and its value is FALSE, the builder is not be instantiated.
Name
Data type: string
Access type: Read/write
Qualifiers: Key
Unique identifier of this template builder.
NamespaceProperty
Data type: string
Access type: Read/write
Option that represents a property on the template object. When the object is created, the value of this property specifies the namespace in which the target is created.
Order
Data type: sint32
Access type: Read/write
Option specifying the order in which this object is instantiated by the template provider. The Order value is an integer that specifies all builder objects that have an order X are instantiated before builder objects having an order Y, where X < Y. If no order is specified, then it is defaulted to 0 (zero).
Target
Data type: object
Access type: Read/write
Qualifiers: Not_Null
An embedded object that is instantiated by a Provider::PutInstance call with Target as an argument. For more information, see the Remarks section of this topic.
Template
Data type: string
Access type: Read/write
Qualifiers: Key
Identifier of the template class for which this template builder is specified.
Remarks
If the instance to be created by the builder is not parameterized by any template arguments, the Target property is a simple embedded object, as in the following example.
Instance of MSFT_TemplateBuilder
{
Name = "ExampleBuilder";
Template = "CorrelationTemplate";
Target = instance of __EventFilter
{
Query = "SELECT * FROM __InstanceModificationEvent "
"WHERE TargetInstance ISA 'MyClass'";
};
};
In most cases, however, the values in the object to be created are parameterized by the values in the template. For instance, in the above example, the Template Creator might want to register a filter for events of the type specified in the WatchClass property of the template. Three instance-level property qualifiers are available to allow parameterization of objects.
Note Any user with partial write privileges in a namespace can modify a template definition. Even though the user does not have the permissions needed to instantiate the template, if the template is instantiated by an administrator, the template creates objects using administrator permissions.
Examples
For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.
For C++ code examples, see WMI C++ Application Examples.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
None supported |
End of client support |
Windows XP |
Namespace |
\root\subscription |
MOF |
Tpmlprov.mof |
DLL |
Tpmlprov.dll |