Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in microsoft.metadirectoryservicesex.dll)
Usage
Visual Basic |
---|
Dim instance As ManagementAgent Dim parts As Value() Dim returnValue As ReferenceValue returnValue = instance.EscapeDNComponent(parts) |
Syntax
Visual Basic |
---|
Public MustOverride Function EscapeDNComponent ( _ ParamArray parts As Value() _ ) As ReferenceValue |
C# |
---|
public abstract ReferenceValue EscapeDNComponent ( params Value[] parts ) |
C++ |
---|
public: virtual ReferenceValue^ EscapeDNComponent ( ... array<Value^>^ parts ) abstract |
J# |
---|
public abstract ReferenceValue EscapeDNComponent ( Value[] parts ) |
JScript |
---|
public abstract function EscapeDNComponent ( ... parts : Value[] ) : ReferenceValue |
Parameters
- parts
-
Contains an array of Value objects that are used to build the distinguished name component.
Return Value
Returns a ReferenceValue object that represents the escaped distinguished name component.Exceptions
Exception type | Condition |
---|---|
System.ArgumentException |
The management agent requires a distinguished name that has a single component, and the parts parameter contains zero components or more than one component. |
System.OutOfMemoryException |
A memory allocation failure occurred. |
Remarks
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 |
|
||
Hierarchical non-LDAP |
|
||
Extrinsic |
|