SafeArrayDestroyDescriptor (Windows CE 5.0)
This function destroys a descriptor of a safearray.
HRESULT SafeArrayDestroyDescriptor(SAFEARRAY FAR* psa );
Parameters
- psa
[in] Pointer to a safearray descriptor.
Return Values
Returns the HRESULT values shown in the following table.
| Value | Description |
|---|---|
| S_OK | Success. |
| DISP_E_ARRAYISLOCKED | The array is locked. |
| E_INVALIDARG | The item pointed to by psa is not a safearray descriptor. |
Remarks
Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.
Typically, this function is used to destroy the descriptor of a safearray that contains elements with data types other than variants.
Destroying the array descriptor does not destroy elements in the array.
Before destroying the array descriptor, call SafeArrayDestroyData to free the elements.
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Oleauto.h.
Link Library: Oleaut32.lib.
See Also
Automation Functions | SafeArrayDestroyData
Send Feedback on this topic to the authors