PhysicalName::QualifiedFullName

Repeated capability physical names can be either qualified or unqualified. Qualified physical names include the prefix of the repeated capability itself followed by a !!. These qualifiers are used to uniquely identify repeated capability instances in cases where the unqualified physical name alone would not be unique. For instance, a driver may define both a "Measurement" and a "Channel" repeated capability with a physical name of C1. The physical name recorded in the IVI Configuration Store must be unique across the driver, so the qualified name would be used for each, yielding Measurement!!C1 and Channel!!C1.

The following example demonstrates use of the QualifiedFullName function.

ViStatus _VI_FUNC acme4321_ConfigureArmCount(ViSession Vi, ViConstString RepCapIdentifier, ViInt32 ArmCount)
{
    // Assume the Trace repeated capability is defined as a child of the Channel repeated capability
    // 
    PhysicalName<Trace> trace("C1:T2");

    cout << trace.QualifiedFullName();   // prints "Channel!!C1::Trace!!T2"
}