Share via


WriteBSTR (Windows Embedded CE 6.0)

1/6/2010

This function allocates and fills a task-allocated BSTR string.

Syntax

STDAPI WriteBSTR(
  BSTR* pstrDest,
  LPCWSTR szSrc
);

Parameters

  • pstrDest
    Pointer to where the address of the allocated BSTR will be stored.
  • szSrc
    Wide (Unicode) string that will be copied to the newly allocated BSTR string.

Return Value

Returns an HRESULT value.

Remarks

Memory is allocated for passing between objects across interfaces by calling CoTaskMemAlloc.

Memory is freed by calling CoTaskMemFree.

By using a central memory allocator, memory can be allocated, passed, and freed safely between objects created in different programming languages.

Requirements

Windows Embedded CE Windows CE 2.12 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

See Also

Reference

BSTR Functions