FreeBSTR (Compact 2013)

3/26/2014

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

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

BSTR Functions