CComBSTR::Append

Artículo
06/09/2015

Anexa lpsz o miembro de BSTR de bstrSrc a m_str.

HRESULT Append( 
   const CComBSTR& bstrSrc  
) throw( ); 
HRESULT Append( 
   wchar_t ch 
) throw( ); 
HRESULT Append( 
   char ch 
) throw( ); 
HRESULT Append( 
   LPCOLESTR lpsz  
) throw( ); 
HRESULT Append( 
   LPCSTR lpsz  
) throw( ); 
HRESULT Append( 
   LPCOLESTR lpsz, 
   int nLen  
) throw( );

Parámetros

bstrSrc
[in] Un objeto de CComBSTR para anexar.
ch
[in] Un carácter para anexar.
lpsz
[in] Una cadena de caracteres terminada en cero para anexar. Puede pasar una cadena Unicode mediante la sobrecarga de LPCOLESTR o una cadena ANSI mediante la versión de LPCSTR .
nLen
[in] El número de caracteres de lpsz para anexar.

Valor devuelto

S_OK en correctamente, o cualquier valor de error estándar de HRESULT .

Comentarios

Una cadena ANSI se convertirá en Unicode antes de ser anexado.

Ejemplo

enum { urlASP, urlHTM, urlISAPI } urlType;
urlType = urlASP;

CComBSTR bstrURL = OLESTR("http://SomeSite/");
CComBSTR bstrDEF = OLESTR("/OtherSite");
CComBSTR bstrASP = OLESTR("default.asp");

CComBSTR bstrTemp;
HRESULT hr;

switch (urlType)
{
case urlASP:
   // bstrURL is 'http://SomeSite/default.asp'
   hr = bstrURL.Append(bstrASP);
   break;

case urlHTM:
   // bstrURL is 'http://SomeSite/default.htm'
   hr = bstrURL.Append(OLESTR("default.htm"));
   break;

case urlISAPI:
   // bstrURL is 'http://SomeSite/default.dll?func'
   hr = bstrURL.Append(OLESTR("default.dll?func"));
   break;

default:
   // bstrTemp is 'http://'
   hr = bstrTemp.Append(bstrURL, 7);
   // bstrURL is 'http://OtherSite' 
   if (hr == S_OK)
       hr = bstrTemp.Append(bstrDEF);
   bstrURL = bstrTemp;

   break;
}