SafeArrayDestroyData-Funktion (oleauto.h)
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 |
|---|---|
|
Erfolg. |
|
Das Argument psa war ungültig. |
|
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 |