Compartilhar via


Função SafeArrayDestroy (oleauto.h)

Destrói um descritor de matriz existente e todos os dados na matriz. Se os objetos forem armazenados na matriz, Release será chamado em cada objeto na matriz.

Sintaxe

HRESULT SafeArrayDestroy(
  [in] SAFEARRAY *psa
);

Parâmetros

[in] psa

Um descritor de matriz criado por SafeArrayCreate.

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

Comentários

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.

Exemplos

STDMETHODIMP_(ULONG) CEnumPoint::Release()
{
   if(--m_refs == 0){
      if(m_psa != NULL)
      SafeArrayDestroy(m_psa);
      delete this;
      return 0;
   }
   return m_refs;
}

Requisitos

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