CComBSTR::Append

Artigo
02/25/2013

Acrescenta lpsz ou membro 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] objeto de CComBSTR a acrescentar.
ch
[in] caractere da acrescentar.
lpsz
[in] A zero finalizou a cadeia de caracteres para acrescentar.Você pode passar uma cadeia de caracteres Unicode através da sobrecarga de LPCOLESTR ou uma cadeia de caracteres ANSI através da versão de LPCSTR .
nLen
[in] número de caracteres de lpsz a acrescentar.

Valor de retorno

NoS_OK êxito, ou qualquer valor de erro de HRESULT do padrão.

Comentários

Uma cadeia de caracteres ANSI será convertida para Unicode antes de ser anexada.

Exemplo

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;
}