Compartilhar via

Função SafeArrayRedim (oleauto.h)

  • Artigo

Altera o limite mais à direita (menos significativo) da matriz segura especificada.

Sintaxe

HRESULT SafeArrayRedim(
  [in, out] SAFEARRAY      *psa,
  [in]      SAFEARRAYBOUND *psaboundNew
);

Parâmetros

[in, out] psa

Um descritor de matriz segura.

[in] psaboundNew

Uma nova estrutura associada à matriz segura que contém o novo limite de matriz. Você pode alterar apenas a dimensão menos significativa de uma matriz.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_INVALIDARG
 O argumento psa não é válido.
DISP_E_ARRAYISLOCKED
 A matriz está bloqueada.

Comentários

Se você reduzir o limite de uma matriz, SafeArrayRedim desalocará os elementos da matriz fora do novo limite da matriz. Se o limite de uma matriz for aumentado, SafeArrayRedim alocará e inicializará os novos elementos da matriz. Os dados são preservados para elementos que existem na matriz antiga e nova.

Requisitos

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