CComBSTR::Append

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

bstrSrc の lpsz または BSTR メンバを CComBSTR::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( );

パラメータ

bstrSrc
[入力] 追加する CComBSTR オブジェクト。
ch
[入力] 追加する文字。
lpsz
[入力] 追加する 0 で終わる文字列。LPCOLESTR オーバーロードを使用して Unicode 文字列を渡すか､LPCSTR バージョンを使用して ANSI 文字列を渡すことができます。
nLen
[入力] lpsz から追加する文字数です。

戻り値

正常に終了した場合は、S_OK を返します。それ以外の場合は、標準の HRESULT エラー値を返します。

解説

ANSI 文字列は、追加される前に Unicode に変換されます。

使用例

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