Table of Contents

DMS_GET_ELEMENTS_USING_PROTOCOL (102)

Warning

The use of DMS Notify types has been deprecated. Use types from the Class Library instead.

Gets elements using the specified protocol.

object result;

string protocolName = "Microsoft Platform";
string protocolVersion = "Production";

int type = 102;
int subType = 0;

string[] protocolDetails = new string[]{protocolName, protocolVersion};
bool activeOnly = true;

DMS dms = new DMS();
dms.Notify(type/* DMS_GET_ELEMENTS_USING_PROTOCOL */, subType, protocolDetails, activeOnly, out result);

if (result != null)
{
    string[] globalElementIDs = (string[])result;
    
    foreach (string globalElementID in globalElementIDs)
    {
        ////....
    }
}

Parameters

  • type (int): Specifies the notify type. To perform a DMS_GET_ELEMENTS_USING_PROTOCOL call, set this to 102.

  • subType (int): Specifies the sub type. Not applicable for DMS_GET_ELEMENTS_USING_PROTOCOL calls. Set this to 0.

  • protocolDetails (string[] or string):

    In case protocolDetails is of type string[]:

    • protocolDetails[0]: Name of the protocol.
    • protocolDetails[1]: Version of the protocol.

    In case protocolDetails is of type string[]:

    • activeOnly (boolean): Set to true in case you only want to retrieve active elements. Otherwise set to false (or provide null for this argument).
    • result (object): Overview of all elements that use this protocol version as a string array containing the global element IDs (DMA ID/Element ID).