WriteBSTR

Allocates and fills a task-allocated BSTR string.

Syntax

STDAPI WriteBSTR(
    BSTR *pstrDest,
    LPCWSTR szSrc
);

Parameters

pstrDest

Pointer to where the allocated BSTR will be stored.

szSrc

Pointer to a wide-character 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. It 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.

See Also

• String Functions