Funzione SafeArrayRedim (oleauto.h)

Articolo
03/01/2024

Modifica il limite più corretto (meno significativo) della matrice sicura specificata.

Sintassi

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

Parametri

[in, out] psa

Descrittore di matrice sicuro.

[in] psaboundNew

Nuova struttura associata a matrice sicura che contiene il nuovo limite di matrice. È possibile modificare solo la dimensione meno significativa di una matrice.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	L'argomento psa non è valido.
DISP_E_ARRAYISLOCKED	La matrice è bloccata.

Commenti

Se si riduce il limite di una matrice, SafeArrayRedim dealloca gli elementi della matrice all'esterno del nuovo limite di matrice. Se il limite di una matrice è aumentato, SafeArrayRedim alloca e inizializza i nuovi elementi della matrice. I dati vengono conservati per gli elementi presenti sia nella matrice precedente che nella nuova matrice.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	oleauto.h
Libreria	OleAut32.lib
DLL	OleAut32.dll

Condividi tramite