CComBSTR (clase)

Esta clase es un contenedor para s para BSTR.

class CComBSTR

Members

Constructores públicos

Name	Descripción
CComBSTR::CComBSTR	el constructor.
CComBSTR::~CComBSTR	El destructor.

Métodos públicos

Name	Descripción
CComBSTR::Append	anexa una cadena a m_str.
CComBSTR::AppendBSTR	anexa BSTR a m_str.
CComBSTR::AppendBytes	anexa un número de bytes especificado a m_str.
CComBSTR::ArrayToBSTR	Crea BSTR del primer carácter de cada elemento del safearray y lo asocia al objeto de CComBSTR .
CComBSTR::AssignBSTR	asigna BSTR a m_str.
CComBSTR::Attach	Asocia BSTR al objeto de CComBSTR .
CComBSTR::BSTRToArray	Crea un safearray unidimensional basada en cero, donde es un carácter cada elemento de matriz de objetos de CComBSTR .
CComBSTR::ByteLength	devuelve la longitud de m_str en bytes.
CComBSTR::Copy	devuelve una copia de m_str.
CComBSTR::CopyTo	Devuelve una copia de m_str mediante un parámetro de [out]
CComBSTR::Detach	Desasocia m_str del objeto de CComBSTR .
CComBSTR::Empty	libera m_str.
CComBSTR::Length	devuelve la longitud de m_str.
CComBSTR::LoadString	carga un recurso de cadena.
CComBSTR::ReadFromStream	carga un objeto de BSTR de una secuencia.
CComBSTR::ToLower	Convierte la cadena en minúsculas.
CComBSTR::ToUpper	Convierte la cadena a mayúsculas.
CComBSTR::WriteToStream	Guarda m_str en una secuencia.

Operadores públicos

Name	Descripción
CComBSTR::operator BSTR	Convierte un objeto de CComBSTR a BSTR.
CComBSTR::operator !	devuelve true o false, dependiendo de si m_stres NULL.
CComBSTR::operator !=	compara CComBSTR con una cadena.
CComBSTR::operator &	Devuelve la dirección de m_str.
CComBSTR::operator +=	Anexa CComBSTR al objeto.
CComBSTR::operator <	compara CComBSTR con una cadena.
CComBSTR::operator =	asigna un valor a m_str.
CComBSTR::operator ==	compara CComBSTR con una cadena.
CComBSTR::operator >	compara CComBSTR con una cadena.

Miembros de datos públicos

Name	Descripción
CComBSTR::m_str	contiene BSTR asociado con el objeto de CComBSTR .

Comentarios

La clase de CComBSTR es un contenedor para s para BSTR, que son cadenas longitud-prefijadas. La longitud se almacena como entero en la ubicación de memoria que precede a los datos de la cadena.

BSTR terminado en null cuando el carácter contado último pero también pueda contener caracteres null incrustados dentro de la cadena. La longitud de la cadena está determinada por el recuento de caracteres, no el primer carácter nulo.

Nota

La clase de CComBSTR proporciona varios miembros (constructores, operadores de asignación, y operadores de comparación) que toma ANSI o cadenas Unicode como argumentos.Las versiones ANSI de estas funciones son menos eficaces que sus homólogos de Unicode porque las cadenas Unicode temporales se crean a menudo internamente.Para aumentar la eficacia, utilice las versiones Unicode cuando sea posible.

Nota

Debido al comportamiento mejorado de búsqueda implementado en Visual Studio .NET, el código como bstr = L"String2" + bstr;, que pueden tener compilado en versiones anteriores, se debe en su lugar implementar como bstr = CStringW(L"String2") + bstr.

Para obtener una lista de precauciones al utilizar CComBSTR, vea programación con CComBSTR.

Requisitos

encabezado: atlbase.h

Vea también

Conceptos

ATL and MFC String Conversion Macros

Otros recursos

ATL Class Overview