The EscapeDNComponent(String) method creates a ReferenceValue object that contains an escaped distinguished name component from an array of strings. The strings should not contain escaped characters.
public ReferenceValue EscapeDNComponent( String parts );
Public Function EscapeDNComponent( _ ByVal parts As String _ ) As ReferenceValue
Contains an array of strings that will be used to build the distinguished name component. The strings should not contain escaped characters.
Returns a ReferenceValue object that represents the escaped distinguished name component.
The management agent requires a distinguished name with 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 RDNs.
Because different management agents require different distinguished name formats, this method processes the input strings based upon the type of management agent. The types are LDAP distinguished name, such as Active Directory, Sun ONE Directory Server 5.1 (formerly iPlanet Directory Server), 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||
Note The validation of distinguished names is less strict than the syntax defined in the LDAP specifications. EscapeDNComponent(String) allows a part name to contain any combination of one or more of the characters 'a'-'z', 'A'-'Z', '0'-'9', '-', and '.'.
|Product||ILM 2007 FP1|
|.NET Framework||.NET Framework 2.0|
Send comments about this topic to Microsoft
Build date: 2/16/2009