SafeArrayCopy

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Erstellt eine Kopie eines vorhandenen sichere Arrays.

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

Parameter

  • psa
    Zeiger auf ein Arraydeskriptor SafeArrayCreate erstellt.

  • ppsaOut
    Ein Zeiger auf einen Speicherort in dem neuen Arraydeskriptor zurückgegeben.

Rückgabewert

Der Rückgabewert vom zurückgegebenen HRESULT ist eine der folgenden.

Rückgabewert

Bedeutung

S_OK

Erfolg.

E_INVALIDARG

Argument p PsaOut konnte keinen Deskriptor mit gültigen sicheres Array.

E_OUTOFMEMORY

Nicht genügend Arbeitsspeicher, um die Kopie zu erstellen.

Kommentare

SafeArrayCopy Ruft die Zeichenfolge oder einen Variant Manipulation Funktionen, wenn das Array, kopiert eine der folgenden Datentypen enthält. Wenn das Array kopierten Objektverweise enthält, werden Referenzzähler für die Objekte erhöht.

Siehe auch

Referenz

SysAllocStringLen

VariantCopy

VariantCopyInd