WriteBSTR (Compact 2013)

3/26/2014

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

See Also

Reference

BSTR Functions