Estrutura SAFEARRAY (oaidl.h)

Representa uma matriz segura.

Sintaxe

typedef struct tagSAFEARRAY {
  USHORT         cDims;
  USHORT         fFeatures;
  ULONG          cbElements;
  ULONG          cLocks;
  PVOID          pvData;
  SAFEARRAYBOUND rgsabound[1];
} SAFEARRAY;

Membros

cDims

O número de dimensões.

fFeatures

Sinalizadores.

Valor Significado
FADF_AUTO
0x0001
Uma matriz alocada na pilha.
FADF_STATIC
0x0002
Uma matriz alocada estaticamente.
FADF_EMBEDDED
0x0004
Uma matriz inserida em uma estrutura .
FADF_FIXEDSIZE
0x0010
Uma matriz que pode não ser redimensionada ou realocada.
FADF_RECORD
0x0020
Uma matriz que contém registros. Quando definido, haverá um ponteiro para a interface IRecordInfo no deslocamento negativo 4 no descritor de matriz.
FADF_HAVEIID
0x0040
Uma matriz que tem uma interface de identificação IID. Quando definido, haverá um GUID no deslocamento negativo 16 no descritor de matriz segura. O sinalizador é definido somente quando FADF_DISPATCH ou FADF_UNKNOWN também está definido.
FADF_HAVEVARTYPE
0x0080
Uma matriz que tem um tipo variante. O tipo variante pode ser recuperado com SafeArrayGetVartype.
FADF_BSTR
0x0100
Uma matriz de BSTRs.
FADF_UNKNOWN
0x0200
Uma matriz de IUnknown*.
FADF_DISPATCH
0x0400
Uma matriz de IDispatch*.
FADF_VARIANT
0x0800
Uma matriz de VARIANTs.
FADF_RESERVED
0xF008
Bits reservados para uso futuro.

cbElements

O tamanho de um elemento de matriz.

cLocks

O número de vezes que a matriz foi bloqueada sem um desbloqueio correspondente.

pvData

Os dados.

rgsabound[1]

Um associado para cada dimensão.

Comentários

A matriz rgsabound é armazenada com a dimensão mais à esquerda em rgsabound[0] e a dimensão mais à direita em rgsabound[cDims - 1]. Se uma matriz fosse especificada em uma sintaxe semelhante a C como um [2][5], ela teria dois elementos no vetor rgsabound . O elemento 0 tem um lLbound de 0 e um cElements de 2. O elemento 1 tem um lLbound de 0 e um cElements de 5.

Os sinalizadores fFeatures descrevem atributos de uma matriz que podem afetar como a matriz é liberada. O campo fFeatures descreve que tipo de dados é armazenado no SAFEARRAY e como a matriz é alocada. Isso permite liberar a matriz sem referenciar sua variante que contém.

Acesso thread-safe

Todos os membros estáticos públicos do tipo de dados SAFEARRAY são thread-safe. Não há garantia de que os membros da instância sejam thread-safe.

Por exemplo, considere um aplicativo que usa as funções SafeArrayLock e SafeArrayUnlock . Se essas funções forem chamadas simultaneamente de threads diferentes na mesma instância de tipo de dados SAFEARRAY , uma contagem de bloqueio inconsistente poderá ser criada. Isso eventualmente fará com que a função SafeArrayUnlock retorne E_UNEXPECTED. Você pode evitar isso fornecendo seu próprio código de sincronização.

Requisitos

Requisito Valor
Cabeçalho oaidl.h