Export (0) Print
Expand All
4 out of 8 rated this helpful - Rate this topic

_bstr_t Class

Microsoft Specific

A _bstr_t object encapsulates the BSTR data type. The class manages resource allocation and deallocation through function calls to SysAllocString and SysFreeString and other BSTR APIs when appropriate. The _bstr_t class uses reference counting to avoid excessive overhead.

Construction

_bstr_t

Constructs a _bstr_t object.

Operations

Assign

Copies a BSTR into the BSTR wrapped by a _bstr_t.

Attach

Links a _bstr_t wrapper to a BSTR.

copy

Constructs a copy of the encapsulated BSTR.

Detach

Returns the BSTR wrapped by a _bstr_t and detaches the BSTR from the _bstr_t.

GetAddress

Points to the BSTR wrapped by a _bstr_t.

GetBSTR

Points to the beginning of the BSTR wrapped by the _bstr_t.

length

Returns the number of characters in the _bstr_t.

Operators

operator =

Assigns a new value to an existing _bstr_t object.

operator +=

Appends characters to the end of the _bstr_t object.

operator +

Concatenates two strings.

operator !

Checks if the encapsulated BSTR is a NULL string.

operator ==, !=, <, >, <=, >=

Compares two _bstr_t objects.

operator wchar_t* | char*

Extract the pointers to the encapsulated Unicode or multibyte BSTR object.

Header: comutil.h

Lib: comsuppw.lib or comsuppwd.lib (see /Zc:wchar_t (wchar_t Is Native Type) for more information)

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.