CComBSTR-Klasse

Diese Klasse ist ein Wrapper für BSTR S.

class CComBSTR

Mitglieder

Öffentliche Konstruktoren

Name	Description
CComBSTR::CComBSTR	Der -Konstruktor.
CComBSTR::~CComBSTR	Der Destruktor.

Öffentliche Methoden

Name	Description
CComBSTR::Append	Fügt eine Zeichenfolge zu m_str an.
CComBSTR::AppendBSTR	Fügt BSTR zu m_str an.
CComBSTR::AppendBytes	Fügt eine angegebene Anzahl Bytes zu m_str an.
CComBSTR::ArrayToBSTR	Erstellt BSTR vom ersten Zeichen jedes Elements im safearray und fügt es dem CComBSTR-Objekt.
CComBSTR::AssignBSTR	Weist m_strBSTR zu.
CComBSTR::Attach	Fügt BSTR zum CComBSTR-Objekt.
CComBSTR::BSTRToArray	Erstellt ein nullbasiertes eindimensionales safearray, wobei jedes Element des Arrays ein Zeichen aus dem CComBSTR-Objekt ist.
CComBSTR::ByteLength	Gibt die Länge von m_str in Bytes zurück.
CComBSTR::Copy	Gibt eine Kopie von m_str zurück.
CComBSTR::CopyTo	Gibt eine Kopie von m_str über einen [out]-Parameter zurück
CComBSTR::Detach	Trennt m_str vom CComBSTR-Objekt.
CComBSTR::Empty	Gibt m_str frei.
CComBSTR::Length	Gibt die Länge von m_str zurück.
CComBSTR::LoadString	Lädt eine Zeichenfolgenressource.
CComBSTR::ReadFromStream	Lädt ein BSTR-Objekt aus einem Stream.
CComBSTR::ToLower	Konvertiert die Zeichenfolge in Kleinbuchstaben.
CComBSTR::ToUpper	Konvertiert die Zeichenfolge in Großbuchstaben.
CComBSTR::WriteToStream	Rettet m_str in einem Stream.

Öffentliche Operatoren

Name	Description
CComBSTR::operator BSTR	Wandelt ein CComBSTR-Objekt zu BSTR um.
CComBSTR::operator!	Gibt true oder false, je nachdem, ob m_strNULL ist.
CComBSTR::operator! =	Vergleicht CComBSTR mit einer Zeichenfolge.
CComBSTR::operator &.	Gibt die Adresse von m_str zurück.
CComBSTR::operator +=	Fügt dem Objekt an. CComBSTR
CComBSTR::operator <	Vergleicht CComBSTR mit einer Zeichenfolge.
CComBSTR::operator =	Weist m_str einen Wert zu.
CComBSTR::operator-==	Vergleicht CComBSTR mit einer Zeichenfolge.
CComBSTR::operator >	Vergleicht CComBSTR mit einer Zeichenfolge.

Öffentliche Datenmember

Name	Description
CComBSTR::m_str	Enthält BSTR, das mit dem CComBSTR-Objekt zugeordnet ist.

Hinweise

Die CComBSTR-Klasse ist ein Wrapper für BSTR s, die Länge-vorangestellte Zeichenfolgen sind.Die Länge wird als ganze Zahl an der Speicheradresse gespeichert, die Daten in der Zeichenfolge vorangeht.

BSTR endet auf NULL nach dem letzten gezählten Zeichen enthält jedoch möglicherweise auch die NULL-Zeichen, die innerhalb der Zeichenfolge eingebettet werden.Die Zeichenfolgenlänge wird durch die Zeichenanzahl, nicht das erste NULL-Zeichen bestimmt.

Hinweis

Die CComBSTR-Klasse stellt mehrere Member (Konstruktoren, Zuweisungsoperatoren, und Vergleichsoperatoren) diese nehmen entweder ANSI oder Unicode-Zeichenfolgen als Argumente.Die ANSI-Versionen dieser Funktionen sind weniger effizient als ihre Unicode-Entsprechungen, dass temporäre Unicode-Zeichenfolgen häufig intern erstellt werden.Aus Leistungsgründen verwenden Sie die Unicode-Versionen nach Möglichkeit.

Hinweis
Aufgrund des verbesserten Suchenverhaltens, das in Visual Studio .NET. implementiert wird, sollte Code wie bstr = L"String2" + bstr;, die in früheren Versionen kompiliert, als bstr = CStringW(L"String2") + bstr stattdessen implementiert werden.

Eine Liste der vorsichtig, wenn Sie CComBSTR verwenden, finden Sie unter Programmierung mit CComBSTR.

Anforderungen

Header: atlbase.h

Siehe auch

Konzepte

ATL und Makros für MFC-Zeichenfolgenkonvertierung

Weitere Ressourcen

ATL-Klassenübersicht