Compartir a través de

Función SafeArrayRedim (oleauto.h)

  • Artículo

Cambia el límite más a la derecha (menos significativo) de la matriz segura especificada.

Sintaxis

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

Parámetros

[in, out] psa

Descriptor de matriz seguro.

[in] psaboundNew

Nueva estructura enlazada a matriz segura que contiene el nuevo límite de matriz. Solo puede cambiar la dimensión menos significativa de una matriz.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 El argumento psa no es válido.
DISP_E_ARRAYISLOCKED
 La matriz está bloqueada.

Comentarios

Si reduce el límite de una matriz, SafeArrayRedim desasigna los elementos de la matriz fuera del nuevo límite de la matriz. Si se aumenta el límite de una matriz, SafeArrayRedim asigna e inicializa los nuevos elementos de matriz. Los datos se conservan para los elementos que existen en la matriz antigua y nueva.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado oleauto.h
Library OleAut32.lib
Archivo DLL OleAut32.dll