XdsObjects Help file
XdsObjects Namespace / XdsPatient Class / WithRoot Method

The Root of the domain which is wanted - typically:

The XdsDomain object holding details of the Pix Manager, audit repository etc.



WithRoot Method
Uses a PIX query to lookup the identity of a patient in a different domain - i.e. with a different ID_Root
Syntax
Public Function WithRoot( _
   ByVal WantedRoot As String, _
   ByVal xds As XdsDomain _
) As String
Dim instance As XdsPatient
Dim WantedRoot As String
Dim xds As XdsDomain
Dim value As String
 
value = instance.WithRoot(WantedRoot, xds)
public string WithRoot( 
   string WantedRoot,
   XdsDomain xds
)
public:
String^ WithRoot( 
   String^ WantedRoot,
   XdsDomain^ xds
) 

Parameters

WantedRoot

The Root of the domain which is wanted - typically:

  • For a document consumer, this is the root ID of the local domain
  • For a document source, this is the root ID of the XDS domain
xds
The XdsDomain object holding details of the Pix Manager, audit repository etc.

Return Value

A full ID string in the form LocalID^^^&RootID&ISO
Remarks
See the article on PIX Management in XdsObjects for more details on how this method is used, both explicitly, and implicitly by other methods.
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also