CComBSTR::Append
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;
}
必要条件
ヘッダー: atlbase.h