System.SAFEARRAY
C++
typedef struct tagSAFEARRAY SAFEARRAY;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| typedef | public | sysvari.h | System | System |
Description
Tableau multidimensionnel pour la technologie COM.
SAFEARRAY est une structure contenant des informations sur un tableau : le nombre de dimensions, la taille d'un élément, le nombre de verrous, et ainsi de suite.
Les membres de SAFEARRAY sont :
| cDims | Nombre de dimensions. |
| fFeatures | Indicateurs. |
| cbElements | Taille d'un élément. |
| cLocks | Nombre de verrous. |
| pvData | Pointeur sur les données. |
| rgsabound | Informations de limites pour chaque dimension. Voir TVarArrayBoundArray. Vous pouvez aussi utiliser SAFEARRAYBOUND.
|
SAFEARRAY a été conçue pour être thread-safe. Voir SafeArrayLock et SafeArrayUnlock.
Pour créer une structure SAFEARRAY, utilisez SafeArrayCreate. Pour détruire une structure SAFEARRAY, utilisez SafeArrayDestroy.
Pour faire référence à un élément de SAFEARRAY, vous devez calculer son adresse. Vous pouvez le faire avec les membres pvData et rgsabound de SAFEARRAY. Vous ne pouvez pas utiliser l'opérateur d'indice.