IDiaSymbol11::get_tagRanges

Ruft die Kategorienbereiche innerhalb einer diskriminierten Union-Symbolinstanz ab.

Syntax

HRESULT get_tagRanges(
  DWORD count,
  DWORD *pcRangeValues,
  DiaTagValue *rangeValues
);

Parameter

count

[in] Gibt die Anzahl der gültigen DiaTagValue Elemente an, auf die der rangeValues Parameter verweist.

pcRangeValues

[out] Gibt die Anzahl der DiaTagValue erforderlichen Elemente zurück, wenn rangeValues dies der Fall ist nullptr; andernfalls wird die Anzahl der verwendeten Elemente zurückgegeben.

rangeValues

[out] Gibt ein Array von DiaTagValue. Bei Eingabe wird die Anzahl gültiger Elemente durch den count Parameter angegeben. Bei Rückgabe *pcRangeValues ist die Anzahl der gültigen Elemente, die ausgefüllt wurden.

Rückgabewert

Wenn die Ausführung erfolgreich ist, wird S_OK, andernfalls ein Fehlercode zurückgegeben.

Hinweis

Ein Rückgabewert von S_FALSE bedeutet, dass die Eigenschaft für das Symbol nicht verfügbar ist.

Hinweise

Das erste Arrayelement (rangeValues[0]) stellt die untere Grenze des Bereichs dar. Das nächste Arrayelement stellt die obere Grenze des Bereichs dar. Das Array wechselt weiterhin zwischen unteren und oberen Begrenzungen jedes nachfolgenden Bereichs. Sowohl obere als auch untere Grenzen sind inklusive.

Siehe auch

• IDiaSymbol11
• DiaTagValue