Active Directory Provider::Get Properties
Returns one or more properties for an Active Directory directory service object. Used by Microsoft Provisioning Framework (MPF).
Get Properties is a wrapper for IADS::GetEx.
Arguments
The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.
Element | Description, relationships, and attributes |
---|---|
executeData |
Description: Children: |
path |
Description: Parent: |
properties |
Description: If a property type was not implemented to be returned, no property node is returned. Note that IADs::GetEx returns the same thing for an invalid property name as for a valid property name with no value, so in both cases this action will generate an empty property node. Parent: Child: |
property |
Description: Child: Attributes:
nameName of the property.
|
propertyList |
Description: Parent: Child: Attributes:
nameRequired. Name of the property to retrieve.
|
value |
Description:
Parent: |
Remarks
Active Directory Provider supports the following property types (based on what IADs::GetEx returns):
VT_BOOL
VT_DATE
VT_ARRAY or VT_UI1
Any types used by IXMLDOMText::put_nodeTypedValue (basically, whatever VariantChangeType can convert to VT_BSTR)
Schema Definition
Input
<executeData>1..1
<path>1..1
<propertyList>0..1
<property name="..">0..unbounded</property>
</propertyList>
</executeData>
Output
<executeData>1..1
<properties>1..1
<property name="..">1..unbounded
<value>0..unbounded</value>
</property>
</properties>
</executeData>
Sample Code
Example XML Request
The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.
Example XML Response
The following code fragment shows the format for data this procedure returns. For more information on individual elements and attributes, see the Elements and Attributes table.
Applies To
Active Directory Provider for:
Hosted Messaging and Collaboration version 4.5
Hosted Messaging and Collaboration version 4.0
Hosted Messaging and Collaboration version 3.5
Hosted Messaging and Collaboration version 3.0
Windows-based Hosting version 4.5
Windows-based Hosting version 4.0
Windows-based Hosting version 3.5
Windows-based Hosting for Applications version 1.0
See also
Other Resources
Active Directory Provider::Set Properties [HMC SDK1]