SafeArrayDestroyData
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
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