WriteBSTR
A version of this page is also available for
4/8/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 |
| 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 |