Partager via


CComBSTR, classe

Cette classe est un wrapper pour BSTRS.

class CComBSTR

Membres

Constructeurs publics

Nom

Description

CComBSTR::CComBSTR

Constructeur.

CComBSTR::~CComBSTR

Le destructeur.

Méthodes publiques

Nom

Description

CComBSTR::Append

Ajoute une chaîne à m_str.

CComBSTR::AppendBSTR

Ajoute BSTR à m_str.

CComBSTR::AppendBytes

Ajoute un nombre d'octets spécifié à m_str.

CComBSTR::ArrayToBSTR

Crée BSTR du premier caractère de chaque élément dans un safearray et l'attache à l'objet d' CComBSTR .

CComBSTR::AssignBSTR

Assigne BSTR à m_str.

CComBSTR::Attach

Joint BSTR à l'objet d' CComBSTR .

CComBSTR::BSTRToArray

Crée un safearray unidimensionnel de base zéro, où chaque élément du tableau est un caractère de l'objet d' CComBSTR .

CComBSTR::ByteLength

Retourne la longueur d' m_str en octets.

CComBSTR::Copy

Retourne une copie d' m_str.

CComBSTR::CopyTo

Retourne une copie d' m_str via un paramètre de [out]

CComBSTR::Detach

Détache m_str de l'objet d' CComBSTR .

CComBSTR::Empty

Libère m_str.

CComBSTR::Length

Retourne la longueur d' m_str.

CComBSTR::LoadString

Charge une ressource de type chaîne.

CComBSTR::ReadFromStream

Charge un objet d' BSTR d'un flux.

CComBSTR::ToLower

Convertit la chaîne en minuscules.

CComBSTR::ToUpper

Convertit la chaîne en majuscules.

CComBSTR::WriteToStream

Enregistre m_str dans un flux.

Opérateurs publics

Nom

Description

CComBSTR::operator BSTR

Effectue un objet d' CComBSTR à BSTR.

CComBSTR::operator !

Retourne true ou false, selon que m_strest NULL.

CComBSTR::operator ! =

Compare CComBSTR avec une chaîne.

CComBSTR::operator et

Retourne l'adresse d' m_str.

CComBSTR::operator +=

Ajoute CComBSTR à l'objet.

CComBSTR::operator <

Compare CComBSTR avec une chaîne.

CComBSTR::operator =

Assigne une valeur à m_str.

== De CComBSTR::operator

Compare CComBSTR avec une chaîne.

CComBSTR::operator >

Compare CComBSTR avec une chaîne.

Données membres publiques

Nom

Description

CComBSTR::m_str

Contient BSTR associé à l'objet d' CComBSTR .

Notes

La classe d' CComBSTR est un wrapper pour BSTRs, qui sont des chaînes longueur- préfixées. La longueur est stockée en tant qu'entier à l'emplacement mémoire précédant les données dans la chaîne.

BSTR est se terminant par null après le dernier caractère compté mais peut également contenir des caractères Null incorporés dans la chaîne. La longueur de chaîne n'est déterminée par le nombre de caractères, pas le premier caractère Null.

Notes

La classe d' CComBSTR fournit plusieurs membres (constructeurs, opérateurs d'assignation, et opérateurs de comparaison) qui prennent des chaînes ANSI ou Unicode comme arguments.Les versions ANSI de ces fonctions sont moins efficace que leurs équivalents Unicode parce que les chaînes Unicode temporaires sont souvent créées en interne.Pour des raisons d'efficacité, utilisez les versions Unicode lorsque cela est possible.

Notes

En raison de le comportement amélioré de recherche implémenté dans Visual Studio .NET, le code comme bstr = L"String2" + bstr;, qui peut avoir compilé dans les versions précédentes, doit être implémenté comme bstr = CStringW(L"String2") + bstr.

Pour une liste d'avertissements à l'aide de CComBSTR, consultez programmation avec CComBSTR.

Configuration requise

Header: atlbase.h

Voir aussi

Concepts

Macros de conversion de chaînes ATL et MFC

Autres ressources

Vue d'ensemble de la classe ATL