Función SafeArrayDestroyData (oleauto.h)

Destruye todos los datos de la matriz segura especificada.

Sintaxis

HRESULT SafeArrayDestroyData(
  [in] SAFEARRAY *psa
);

Parámetros

[in] psa

Descriptor de matriz seguro.

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 era válido.
DISP_E_ARRAYISLOCKED
La matriz está bloqueada.

Comentarios

Esta función se usa normalmente al liberar matrices seguras que contienen elementos con tipos de datos distintos de las variantes. Si los objetos se almacenan en la matriz, se llama a Release en cada objeto de la matriz. Las matrices seguras de variante tendrán la función VariantClear llamada en cada miembro y matrices seguras de BSTR tendrá la función SysFreeString llamada en cada elemento. Se llamará a IRecordInfo::RecordClear para liberar referencias de objeto y otros valores de un registro sin desasignar el registro.

Requisitos

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