CComBSTR::Append

Artykuł
02/27/2013

Dołącza albo lpsz lub BSTR członek bstrSrc do 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( );

Parametry

bstrSrc
[w] A CComBSTR obiekt, aby dołączyć.
ch
[w] Aby dołączyć znak.
lpsz
[w] Ciąg znaków zakończony zerem, aby dołączyć.Można przekazać ciąg Unicode, via LPCOLESTR przeciążenia lub ciąg ANSI, via LPCSTR wersji.
nLen
[w] Liczbę znaków z lpsz do dołączania.

Wartość zwracana

S_OKw przypadku sukcesu lub dowolnej normy HRESULT wartość błędu.

Uwagi

Ciąg ANSI są konwertowane na Unicode przed są dołączane.

Przykład

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