IEntityObjectsManagement.GetRelatedObjects Method (ICollection, ManagementPackRelationship, TraversalDepth, ObjectQueryOptions)

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Gets a collection of management pack objects that are related to the list of identifiers. This is further filtered by the management pack relationship, traversal depth, and query options.

Namespace: Microsoft.EnterpriseManagement
Assembly: Microsoft.EnterpriseManagement.Core (in Microsoft.EnterpriseManagement.Core.dll)

Usage

'Usage
Dim instance As IEntityObjectsManagement
Dim instanceIds As ICollection(Of Guid)
Dim relationshipClass As ManagementPackRelationship
Dim traversalDepth As TraversalDepth
Dim queryOptions As ObjectQueryOptions
Dim returnValue As Dictionary(Of Guid, IList(Of T))

returnValue = instance.GetRelatedObjects(instanceIds, relationshipClass, traversalDepth, queryOptions)

Syntax

'Declaration
Function GetRelatedObjects(Of T As EnterpriseManagementObject) ( _
    instanceIds As ICollection(Of Guid), _
    relationshipClass As ManagementPackRelationship, _
    traversalDepth As TraversalDepth, _
    queryOptions As ObjectQueryOptions _
) As Dictionary(Of Guid, IList(Of T))

Dictionary<Guid,IList<T>> GetRelatedObjects<T> (
    ICollection<Guid> instanceIds,
    ManagementPackRelationship relationshipClass,
    TraversalDepth traversalDepth,
    ObjectQueryOptions queryOptions
) where T : EnterpriseManagementObject

generic<typename T> where T : EnterpriseManagementObject
Dictionary<Guid, IList<T>^>^ GetRelatedObjects (
    ICollection<Guid>^ instanceIds, 
    ManagementPackRelationship^ relationshipClass, 
    TraversalDepth traversalDepth, 
    ObjectQueryOptions^ queryOptions
)

GenericParameters

• T
  The type to cast the management pack instances as.

Parameters

• instanceIds
  List of unique object identifiers.

• relationshipClass
  The relationship scope.

• traversalDepth
  One of the enumeration values.

• queryOptions
  The query options.

Return Value

A dictionary object of discovered objects.

Exceptions

Exception type	Condition
ArgumentNullException	The returned instances are null (Nothing in Visual Basic) or the relationshipClass parameter is a null reference.
ArgumentOutOfRangeException	The returned instances are empty.
InvalidOperationException	The returned instances contains duplicates.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Vista, Windows Server 2003, and

Target Platforms

Windows Server 2008,Windows Server 2003

See Also

Reference

IEntityObjectsManagement Interface
IEntityObjectsManagement Members
Microsoft.EnterpriseManagement Namespace