IDebugHostType2::GetArrayDimensions-Methode (dbgmodel.h)
Die GetArrayDimensions-Methode gibt einen Satz von Deskriptoren zurück, einen für jede Dimension des Arrays, wie durch die GetArrayDimensionality-Methode angegeben. Jeder Deskriptor ist eine ArrayDimension-Struktur, die den Anfangsindex, die Länge und den Vorwärtsschritt jeder Arraydimension beschreibt. Dadurch können wesentlich leistungsfähigere Arraykonstrukte beschrieben werden, als im C-Typsystem zulässig sind.
Bei Arrays im C-Stil wird hier eine einzelne Arraydimension mit Werten zurückgegeben, die immer sind:
- LowerBound = 0
- Length = ARRAYSIZE(array)
- Stride = sizeof(elementType)
Syntax
HRESULT GetArrayDimensions(
ULONG64 dimensions,
ArrayDimension *pDimensions
);
Parameter
dimensions
Gibt die Anzahl der abzurufenden Dimensionsdeskriptoren an. Dies muss der Wert sein, der von einem Aufruf von GetArrayDimensionality abgerufen wurde. Ein Puffer von Dimensionen ArrayDimension-Strukturen, die ausgefüllt werden, um das Layout des Arrays im Arbeitsspeicher vollständig zu beschreiben.
pDimensions
Ein Puffer von Dimensionen ArrayDimension-Strukturen, die ausgefüllt werden, um das Layout des Arrays im Arbeitsspeicher vollständig zu beschreiben.
Rückgabewert
Diese Methode gibt HRESULT zurück, was auf Erfolg oder Fehler hinweist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |