Compartilhar via

Função SafeArrayCreateVectorEx (oleauto.h)

  • Artigo

Cria e retorna uma matriz segura unidimensional dos limites e VARTYPE especificados.

Sintaxe

SAFEARRAY * SafeArrayCreateVectorEx(
  [in] VARTYPE vt,
  [in] LONG    lLbound,
  [in] ULONG   cElements,
  [in] PVOID   pvExtra
);

Parâmetros

[in] vt

O tipo base da matriz (o VARTYPE de cada elemento da matriz). O sinalizador FADF_RECORD pode ser definido para VT_RECORD. O FADF_HAVEIID pode ser definido para VT_DISPATCH ou VT_UNKNOWN e FADF_HAVEVARTYPE pode ser definido para todos os outros tipos.

[in] lLbound

O limite inferior para a matriz. Esse parâmetro pode ser negativo.

[in] cElements

O número de elementos na matriz.

[in] pvExtra

As informações de tipo do tipo definido pelo usuário, se você estiver criando uma matriz segura de tipos definidos pelo usuário. Se o parâmetro vt for VT_RECORD, pvExtra será um ponteiro para um IRecordInfo que descreve o registro. Se o parâmetro vt for VT_DISPATCH ou VT_UNKNOWN, pvExtra conterá um ponteiro para um GUID que representa o tipo de interface que está sendo passada para a matriz.

Retornar valor

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

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll