Função SafeArrayCreate (oleauto.h)

Cria um novo descritor de matriz, aloca e inicializa os dados para a matriz e retorna um ponteiro para o novo descritor de matriz.

Sintaxe

SAFEARRAY * SafeArrayCreate(
  [in] VARTYPE        vt,
  [in] UINT           cDims,
  [in] SAFEARRAYBOUND *rgsabound
);

Parâmetros

[in] vt

O tipo base da matriz (o VARTYPE de cada elemento da matriz). O VARTYPE é restrito a um subconjunto dos tipos de variante. Nem o VT_ARRAY nem o sinalizador VT_BYREF podem ser definidos. VT_EMPTY e VT_NULL não são tipos de base válidos para a matriz. Todos os outros tipos são legais.

[in] cDims

O número de dimensões na matriz. O número não pode ser alterado depois que a matriz é criada.

[in] rgsabound

Um vetor de limites (um para cada dimensão) a ser alocado para a matriz.

Retornar valor

Um descritor de matriz segura ou nulo se a matriz não puder ser criada.

Requisitos