SafeArrayCopyData

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function copies the source array to the target array after releasing resources in the target array.

This function is similar to SafeArrayCopy, except that the target array must be set up by the caller. The target is not allocated or reallocated.

Syntax

HRESULT SafeArrayCopyData(
  SAFEARRAY FAR* psaSource, 
  SAFEARRAY FAR* FAR* psaTarget 
);

Parameters

  • psaSource
    [in] Pointer to the safearray to be copied.
  • psaTarget
    [out] On exit, a pointer to the array referred to by psaTarget that contains a copy of the data in psaSource.

Return Value

Returns the HRESULT values shown in the following table.

Value Description

S_OK

Success.

E_INVALIDARG

The psa parameter was not a valid safearray descriptor.

E_OUTOFMEMORY

Insufficient memory to create the copy.

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
SafeArrayCopy