Función PropVariantClear (combaseapi.h)
La función PropVariantClear libera todos los elementos que se pueden liberar en una estructura PROPVARIANT determinada. En el caso de elementos complejos con punteros de elemento conocidos, los elementos subyacentes se liberan antes de liberar el elemento contenedor.
Sintaxis
HRESULT PropVariantClear(
[in] PROPVARIANT *pvar
);
Parámetros
[in] pvar
Puntero a una estructura PROPVARIANT inicializada para la que se liberarán los elementos desasignables. A cambio, todos los ceros se escriben en la estructura PROPVARIANT .
Valor devuelto
Esta función devuelve HRESULT.
Comentarios
En cualquier nivel de direccionamiento indirecto, se omiten los punteros NULL . Por ejemplo, el parámetro pvar apunta a una estructura PROPVARIANT de tipo VT_CF. El miembro pclipdata de la estructura PROPVARIANT apunta a una estructura CLIPDATA . El puntero pClipData de la estructura CLIPDATA es NULL. En este ejemplo, se omite el puntero pClipData . Sin embargo, se libera la estructura CLIPDATA a la que apunta el miembro pclipdata de la estructura PROPVARIANT .
A cambio, esta función escribe ceros en la estructura PROPVARIANT especificada, por lo que el tipo VT es VT_EMPTY.
Pasar NULL como parámetro pvar genera un código de retorno de S_OK.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | combaseapi.h |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |