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
Header | oleauto.h |
Library | oleaut32.lib |
Windows Embedded CE | Windows CE 2.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Automation Functions
VARTYPE
SAFEARRAY
SafeArrayAllocDescriptor
SafeArrayAllocData