ITAddress::get_DialableAddress メソッド (tapi3if.h)

get_DialableAddress メソッドは、このアドレスへの接続に使用できる BSTR を取得します。 BSTR は、電話番号や電子メール名など、別のアプリケーションがこのアドレスへの接続に使用する宛先アドレス文字列に対応します。

構文

HRESULT get_DialableAddress(
  [out] BSTR *pDialableAddress
);

[out] pDialableAddress

ダイヤル可能なアドレス文字列を含む BSTR へのポインター。これは、ITAddress::CreateCall の pDestAddress 引数と一致します。

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドが成功しました。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
E_POINTER	pDialableAddress パラメーターは有効なポインターではありません。

アプリケーションでは、SysFreeString を使用して 、pDialableAddress パラメーターに割り当てられたメモリを解放する必要があります。

この値の可用性は、サービスプロバイダーによって異なります。たとえば、Unimodem サービスプロバイダーによって公開されているアドレスでは、このメソッドは電話番号ではなく空の文字列を返します。