SafeArrayDestroyData
9/8/2008
Essa função destrói todos os dados em um SafeArray.
Syntax
HRESULT SafeArrayDestroyData(
SAFEARRAY FAR* psa
);
Parameters
- psa
[no] Ponteiro para um descritor de matriz.
Return Value
Retorna os valores HRESULT mostrados a seguinte tabela.
Valor | Descrição |
---|---|
S_OK |
O sucesso. |
DISP_E_ARRAYISLOCKED |
A matriz está bloqueado. |
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.
Remarks
Normalmente, essa função é usada quando liberando matrizes seguras que contêm elementos com dados tipos diferentes de variantes.
Se objetos são armazenados na matriz, Lançamento é chamado em cada objeto na matriz.
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
SafeArrayAllocData
SafeArrayAllocDescriptor
SafeArrayDestroyDescriptor