SafeArrayCreateVector

9/8/2008

Essa função cria um matriz unidimensional para os quais o limite inferior é sempre zero. Como uma matriz de segurança criados com SafeArrayCreateVector é um tamanho fixo, a constante FADF_FIXEDSIZE é sempre definido.

Syntax

SAFEARRAY * SafeArrayCreateVector(
  VARTYPE vt, 
  long lLbound, 
  unsigned int cElements 
);

Parameters

• VT
  [no] Tipo base de matriz (o VarType de cada elemento da matriz). O tipo é restrito a um subconjunto da variante tipos. Nem VT_ARRAY o sinalizador VT_BYREF pode ser definido. VT_EMPTY e VT_NULL não são válido tipos de base para a matriz. Todos os outros tipos são legais.

• lLbound
  [no] Inferior ligado para a matriz.

• cElements
  [no] Número de elementos de matriz.

Return Value

Retorna um ponteiro para um SafeArray estrutura.

Remarks

SafeArrayCreateVector Aloca um bloco de memória única que contém um SafeArray estrutura de uma matriz unidimensional (24 bytes), seguida imediatamente por dados de matriz. Todos os existentes trabalho funções matriz segura para matrizes seguras que estão alocados com SafeArrayCreateVector.

Tanto o descritor de matriz o bloco de dados matriz são alocados contiguously em uma alocação, que acelera alocação matriz. No entanto, um usuário pode alocar a área descritor e dados separadamente usando o SafeArrayAllocDescriptor e SafeArrayAllocData funções.

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Requirements

See Also

Reference

Automation Functions
VARTYPE
SAFEARRAY
SafeArrayAllocDescriptor
SafeArrayAllocData