Skip to content

bstr-t-class.md

Latest commit

 

History

History
90 lines (74 loc) · 2.98 KB

bstr-t-class.md

File metadata and controls

90 lines (74 loc) · 2.98 KB
title _bstr_t Class | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
devlang-cpp
ms.tgt_pltfrm
ms.topic language-reference
f1_keywords
_bstr_t
dev_langs
C++
helpviewer_keywords
BSTR object
_bstr_t class
BSTR object, COM encapsulation
ms.assetid 58841fef-fe21-4a84-aab9-780262b5201f
caps.latest.revision 9
author mikeblome
ms.author mblome
manager ghogen
translation.priority.ht
cs-cz
de-de
es-es
fr-fr
it-it
ja-jp
ko-kr
pl-pl
pt-br
ru-ru
tr-tr
zh-cn
zh-tw
translationtype Human Translation
ms.sourcegitcommit 3168772cbb7e8127523bc2fc2da5cc9b4f59beb8
ms.openlocfilehash 3a4641a83dd5b54c596f523bf79ab7d59fc9be53

_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)

See Also

Compiler COM Support Classes