Compartilhar via

Função SafeArrayDestroyData (oleauto.h)

  • Artigo

Destrói todos os dados na matriz segura especificada.

Sintaxe

HRESULT SafeArrayDestroyData(
  [in] SAFEARRAY *psa
);

Parâmetros

[in] psa

Um descritor de matriz segura.

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

Comentários

Normalmente, essa função é usada ao liberar matrizes seguras que contêm elementos com tipos de dados diferentes de variantes. Se os objetos forem armazenados na matriz, Release será chamado em cada objeto na matriz. Matrizes seguras de variante terão a função VariantClear chamada em cada membro e matrizes seguras de BSTR terão a função SysFreeString chamada em cada elemento. IRecordInfo::RecordClear será chamado para liberar referências de objeto e outros valores de um registro sem desalocar o registro.

Requisitos

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