FreeBSTR
A version of this page is also available for
4/8/2010
This function frees a task-allocated BSTR string from memory.
Syntax
STDAPI FreeBSTR(
BSTR* pstr
);
Parameters
- pstr
Address of the BSTR to free.
Return Value
Returns S_OK if successful or S_FALSE if pstr is null.
Remarks
Memory is allocated for passing between objects across interfaces by calling CoTaskMemAlloc.
Memory is freed by calling CoTaskMemFree.
You can allocate, pass, and free memory safely between objects created in different programming languages by using a central memory allocator.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |