SafeArrayDestroy

9/8/2008

Essa função destrói todos os dados na matriz e um descritor de matriz.

Se objetos são armazenados na matriz, Lançamento é chamado em cada objeto na matriz.

Syntax

HRESULT SafeArrayDestroy( 
  SAFEARRAY FAR* psa 
); 

Parameters

• psa
  [no] Ponteiro para uma descritor de matriz criado por SafeArrayCreate.

Return Value

Retorna os valores HRESULT mostrados a seguinte tabela.

Valor	Descrição
S_OK	O sucesso.
DISP_E_ARRAYISLOCKED	A matriz está bloqueado no momento.
E_INVALIDARG	O item apontado pelo psa não é um descritor SafeArray.

Remarks

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Example

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

Requirements

Header	oleauto.h
Library	oleaut32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
SafeArrayCreate