Função SafeArrayCreateVectorEx (oleauto.h)

Artigo
03/05/2024

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

Share via