SafeArrayRedim
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função altera o ligado right-Most ou menos significativo de um SafeArray.
Syntax
HRESULT SafeArrayRedim(
SAFEARRAY FAR* psa,
SAFEARRAYBOUND FAR* psaboundNew
);
Parameters
- psa
[no] Ponteiro para um descritor de matriz.
psaboundNew
[out] Ponteiro para um nova ligado SafeArray estrutura que contém o novo limite matriz.Somente a dimensão menos significativo de uma matriz pode ser alterado.
Return Value
Retorna os valores HRESULT mostrados a seguinte tabela.
| Valor | Descrição |
|---|---|
S_OK |
O sucesso. |
DISP_E_ARRAYISLOCKED |
A matriz está bloqueado. |
E_INVALIDARG |
O item apontado pelo psa não é um descritor SafeArray. |
Remarks
Se você reduzir o ligado de uma matriz, SafeArrayRedim Desaloca elementos de matriz fora o novo limite matriz.
Se o ligado de uma matriz for aumentado, SafeArrayRedim Aloca e inicializa os novos elementos matriz. Os dados são preservados para elementos que existem na matriz antiga e nova.
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 |