Funzione PropVariantClear (combaseapi.h)
La funzione PropVariantClear libera tutti gli elementi che possono essere liberati in una determinata struttura PROPVARIANT . Per gli elementi complessi con puntatori agli elementi noti, gli elementi sottostanti vengono liberati prima di liberare l'elemento contenitore.
Sintassi
HRESULT PropVariantClear(
[in] PROPVARIANT *pvar
);
Parametri
[in] pvar
Puntatore a una struttura PROPVARIANT inizializzata per cui devono essere liberati tutti gli elementi deallocabili. In caso di restituzione, tutti gli zere vengono scritti nella struttura PROPVARIANT .
Valore restituito
Questa funzione restituisce HRESULT.
Commenti
A qualsiasi livello di riferimento indiretto, i puntatori NULL vengono ignorati. Ad esempio, il parametro pvar punta a una struttura PROPVARIANT di tipo VT_CF. Il membro pclipdata della struttura PROPVARIANT punta a una struttura CLIPDATA . Il puntatore pClipData nella struttura CLIPDATA è NULL. In questo esempio il puntatore pClipData viene ignorato. Tuttavia, la struttura CLIPDATA a cui punta il membro pclipdata della struttura PROPVARIANT viene liberata.
In caso di restituzione, questa funzione scrive zere nella struttura PROPVARIANT specificata, quindi il tipo VT è VT_EMPTY.
Il passaggio di NULL come parametro pvar produce un codice restituito di S_OK.
Requisiti
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | combaseapi.h |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |