Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SafeArrayCopy function

Creates a copy of an existing safe array.

Syntax


HRESULT SafeArrayCopy(
  _In_  SAFEARRAY *psa,
  _Out_ SAFEARRAY **ppsaOut
);

Parameters

psa [in]

A safe array descriptor created by SafeArrayCreate.

ppsaOut [out]

The safe array descriptor.

Return value

This function can return one of these values.

Return codeDescription
S_OK

Success.

E_INVALIDARG

The argument psa was not valid.

E_OUTOFMEMORY

Insufficient memory to complete the operation.

 

Remarks

SafeArrayCopy calls the string or variant manipulation functions if the array to copy contains either of these data types. If the array being copied contains object references, the reference counts for the objects are incremented.

Requirements

Header

OleAuto.h

Library

OleAut32.lib

DLL

OleAut32.dll

See also

SysAllocStringLen
VariantCopy
VariantCopyInd

 

 

Show:
© 2016 Microsoft