SafeArrayDestroyData-Funktion (oleauto.h)

  • Artikel

Zerstört alle Daten im angegebenen sicheren Array.

Syntax

HRESULT SafeArrayDestroyData(
  [in] SAFEARRAY *psa
);

Parameter

[in] psa

Ein sicherer 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.
DISP_E_ARRAYISLOCKED
 Das Array ist gesperrt.

Hinweise

Diese Funktion wird in der Regel verwendet, wenn sichere Arrays freigegeben werden, die Elemente mit anderen Datentypen als Varianten enthalten. Wenn Objekte im Array gespeichert werden, wird Release für jedes Objekt im Array aufgerufen. Sichere Arrays von variant verfügen über die VariantClear-Funktion , die auf jedem Member aufgerufen wird, und sichere Arrays von BSTR verfügen über die SysFreeString-Funktion , die für jedes Element aufgerufen wird. IRecordInfo::RecordClear wird aufgerufen, um Objektverweise und andere Werte eines Datensatzes freizugeben, ohne die Zuordnung des Datensatzes aufzugeben.

Anforderungen

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