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