SafeArrayCopy-Funktion (oleauto.h)

Erstellt eine Kopie eines vorhandenen sicheren Arrays.

Syntax

HRESULT SafeArrayCopy(
  [in]  SAFEARRAY *psa,
  [out] SAFEARRAY **ppsaOut
);

Parameter

[in] psa

Ein sicherer Arraydeskriptor, der von SafeArrayCreate erstellt wurde.

[out] ppsaOut

Der sichere Arraydeskriptor.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Das Argument psa war ungültig.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.

Hinweise

SafeArrayCopy ruft die Zeichenfolgen- oder Variantenbearbeitungsfunktionen auf, wenn das zu kopierende Array einen dieser Datentypen enthält. Wenn das zu kopierende Array Objektverweise enthält, werden die Verweisanzahlen für die Objekte erhöht.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	oleauto.h
Bibliothek	OleAut32.lib
DLL	OleAut32.dll

Weitere Informationen

SysAllocStringLen

VariantCopy

VariantCopyInd