ManagementAgent.EscapeDNComponent Method (Value)
Assembly: Microsoft.MetadirectoryServicesEx (in Microsoft.MetadirectoryServicesEx.dll)
'Usage Dim instance As ManagementAgent Dim parts As Value() Dim returnValue As ReferenceValue returnValue = instance.EscapeDNComponent(parts)
'Declaration Public MustOverride Function EscapeDNComponent ( _ ParamArray parts As Value() _ ) As ReferenceValue
public abstract ReferenceValue EscapeDNComponent ( params Value parts )
public: virtual ReferenceValue^ EscapeDNComponent ( ... array<Value^>^ parts ) abstract
public abstract ReferenceValue EscapeDNComponent ( Value parts )
public abstract function EscapeDNComponent ( ... parts : Value ) : ReferenceValue
Contains an array of Value objects that are used to build the distinguished name component.
Returns a ReferenceValue object that represents the escaped distinguished name component.
The management agent requires a distinguished name that has a single component, and the parts parameter contains zero components or more than one component.
A memory allocation failure occurred.
You can use this method to handle multi-part relative distinguished names (RDNs).
Because different management agents require different distinguished name formats, this method processes the input strings based on the type of management agent. The types are Lightweight Directory Access Protocol (LDAP) distinguished name, such as Active Directory Domain Services (AD DS), Sun ONE Directory Server 5.1 (formerly iPlanet Directory Server), Microsoft Exchange, and XMLMA with LDAP distinguished names; hierarchical non-LDAP, such as Windows NT and Lotus Notes; and extrinsic, such as database and XML without LDAP distinguished names.
|Management agent type||Processing|
LDAP Distinguished Name
The validation of distinguished names is less strict than the syntax that is defined in the LDAP specifications. EscapeDNComponent allows a part name to contain any combination of one or more of the characters 'a'-'z', 'A'-'Z', '0'-'9', '-', and '.'.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.