Export (0) Print
Expand All
5 out of 12 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 length of the encapsulated BSTR.

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.

END Microsoft Specific

Requirements

Header: comutil.h

Lib: comsupp.lib

See Also

Compiler COM Support Class Overview

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.