Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The latest version of this topic can be found at _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. |
END Microsoft Specific
Requirements
Header: comutil.h
Lib: comsuppw.lib or comsuppwd.lib (see /Zc:wchar_t (wchar_t Is Native Type) for more information)