System.SAFEARRAY
C++
typedef struct tagSAFEARRAY SAFEARRAY;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| typedef | public | sysvari.h | System | System |
Beschreibung
Multidimensionales Array für die COM-Technologie.
SAFEARRAY ist eine Struktur mit Informationen über ein Array: Anzahl der Dimensionen, Größe eines Elements, Anzahl der Sperren usw.
Die Member von SAFEARRAY sind:
| cDims | Anzahl der Dimensionen. |
| fFeatures | Flags. |
| cbElements | Größe eines Elements. |
| cLocks | Anzahl der Sperren. |
| pvData | Zeiger auf Daten. |
| rgsabound | Größeninformation für jede Dimension. Siehe TVarArrayBoundArray. Sie können auch SAFEARRAYBOUND verwenden.
|
SAFEARRAY ist Thread-sicher. Siehe SafeArrayLock und SafeArrayUnlock.
Verwenden Sie zum Erstellen eines SAFEARRAY SafeArrayCreate. Verwenden Sie zum Freigeben eines SAFEARRAY SafeArrayDestroy.
Um ein SAFEARRAY-Element zu referenzieren, müssen Sie dessen Adresse berechnen. Verwenden Sie dazu die Member pvData und rgsabound von SAFEARRAY. Der Indizierungsoperator kann nicht verwendet werden.