Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in microsoft.metadirectoryservicesex.dll)
Usage
| Visual Basic |
|---|
Dim instance As IMASynchronization Dim joinCriteriaName As String Dim csentry As CSEntry Dim rgmventry As MVEntry() Dim imventry As Integer Dim MVObjectType As String Dim returnValue As Boolean returnValue = instance.ResolveJoinSearch(joinCriteriaName, csentry, rgmventry, imventry, MVObjectType) |
Syntax
| Visual Basic |
|---|
Function ResolveJoinSearch ( _ joinCriteriaName As String, _ csentry As CSEntry, _ rgmventry As MVEntry(), _ <OutAttribute> ByRef imventry As Integer, _ ByRef MVObjectType As String _ ) As Boolean |
| C# |
|---|
bool ResolveJoinSearch ( string joinCriteriaName, CSEntry csentry, MVEntry[] rgmventry, out int imventry, ref string MVObjectType ) |
| C++ |
|---|
bool ResolveJoinSearch ( String^ joinCriteriaName, CSEntry^ csentry, array<MVEntry^>^ rgmventry, [OutAttribute] int% imventry, String^% MVObjectType ) |
| J# |
|---|
boolean ResolveJoinSearch ( String joinCriteriaName, CSEntry csentry, MVEntry[] rgmventry, /** @attribute OutAttribute() */ /** @ref */ int imventry, /** @ref */ String MVObjectType ) |
| JScript |
|---|
|
|
Parameters
- joinCriteriaName
-
Contains a string that contains the name of the join criteria. You must use only alphanumeric characters for the joinCriteriaName parameter, otherwise you can encounter problems in a rules extension.
- csentry
-
Contains the CSEntry object that represents the connector space entry that will be joined to the metaverse entry.
- rgmventry
-
Contains an array of CSEntry objects that represent the metaverse entries that match the join operation criteria. On return, the imventry parameter receives the index of the object in this array to which the connector space entry will be joined.
- imventry
-
If the method returns true, this parameter receives the index of the object in the rgmventry parameter to which the connector space entry will be joined.
- MVObjectType
-
Contains a string that contains the name of the metaverse class.
Return Value
Returns true if the join operation can be resolved. The imventry parameter receives the index of the object in the rgmventry array to which the connector space entry will be joined. Returns false if the connector space entry should not be joined to any of the metaverse entries.Example
The following example shows an implementation of this method. The method returns true and sets the index number of the CSEntry object in the collection if there is a CSEntry object type that is equal to the CSEntry object type. If there is no match, the method returns false, and the index number is set to -1.
| Visual Basic |  Copy Code |
|---|---|
Public Function ResolveJoinSearch(ByVal JoinResolution As String, _
ByVal csentry As CSEntry, _
ByVal rgmventry() As MVEntry, _
ByRef imventry As Integer, ByRef MVObjectClass As String) _
As Boolean Implements IMASynchronization.ResolveJoinSearch
ResolveJoinSearch = False
imventry = -1
If csentry("employeeType").IsPresent Then
Dim csemployeeType As String
Dim mventry As MVEntry
Dim index As Int32
index = 0
csemployeeType = csentry("employeeType").Value
For Each mventry In rgmventry
If mventry("employeeType").IsPresent AndAlso _
mventry("employeeType").Value.Equals(csemployeeType) Then
ResolveJoinSearch = True
imventry = index
Exit Function
End If
index = index + 1
Next
End If
End Function
|
|
| C# | Copy Code |
|---|---|
bool IMASynchronization.ResolveJoinSearch (string JoinResolution,
CSEntry csentry,
MVEntry[] rgmventry,
out int iMVEntry,
ref string MvObjectClass)
{
bool ReturnValue = false;
iMVEntry = -1;
if (csentry["employeeType"].IsPresent)
{
string csemployeeType = csentry["employeeType"].Value;
int index = 0;
foreach (MVEntry mventry in rgmventry)
{
if (mventry["employeeType"].IsPresent &&
mventry["employeeType"].Value.Equals(csemployeeType))
{
ReturnValue = true;
iMVEntry = index;
return ReturnValue;
}
index ++;
}
}
return ReturnValue;
}
|
|
Exceptions
| Exception type | Condition |
|---|---|
| EntryPointNotImplementedException |
The rules extension does not implement this method. |
| UnexpectedDataException |
The method received unexpected data. |