Funzione SafeArrayDestroyData (oleauto.h)
Elimina tutti i dati nella matrice sicura specificata.
Sintassi
HRESULT SafeArrayDestroyData(
[in] SAFEARRAY *psa
);
Parametri
[in] psa
Descrittore di matrice sicuro.
Valore restituito
Questa funzione può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
L'argomento psa non è valido. |
|
La matrice è bloccata. |
Commenti
Questa funzione viene in genere usata quando si liberano matrici sicure che contengono elementi con tipi di dati diversi dalle varianti. Se gli oggetti vengono archiviati nella matrice, Release viene chiamato su ogni oggetto nella matrice. Le matrici sicure di variant avranno la funzione VariantClear chiamata in ogni membro e matrici sicure di BSTR avrà la funzione SysFreeString chiamata su ogni elemento. IRecordInfo::RecordClear verrà chiamato per rilasciare riferimenti a oggetti e altri valori di un record senza deallocare il record.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | oleauto.h |
| Libreria | OleAut32.lib |
| DLL | OleAut32.dll |