次の方法で共有


ITPhone::EnumeratePreferredAddresses メソッド (tapi3if.h)

EnumeratePreferredAddresses メソッドは、電話オブジェクトの優先アドレスを列挙します。 このメソッドを実行する前に、アプリケーションで ITPhone::Open を呼び出す必要はありません。

このメソッドは、C/C++ アプリケーションを対象としています。 Visual Basic およびスクリプト アプリケーションでは 、get_Addresses メソッドを使用する必要があります。

構文

HRESULT EnumeratePreferredAddresses(
  [out] IEnumAddress **ppEnumAddress
);

パラメーター

[out] ppEnumAddress

成功した場合、メソッドはアドレスの一覧を含む列挙オブジェクトへのポインターを配置する場所へのポインター。 詳細については、「解説」を参照してください。

戻り値

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

意味
S_OK
メソッドが成功しました。
E_POINTER
ppEnumAddress パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
列挙オブジェクトを割り当てるのに十分なメモリがありません。

注釈

システムに使用可能なアドレスが存在しない場合、このメソッドは空の列挙を生成し、S_OKを返します。

電話デバイスは、デバイス クラス tapi/line で TAPI 2.x phoneGetID 関数を使用してアドレス/回線 ID を返すことによって、アドレスまたはアドレスのセットに優先されると宣言します。

phoneGetID 関数には、開いている電話デバイスへのハンドルが必要ですが、アプリケーションは EnumeratePreferredAddresses を呼び出す前に ITPhone::Open メソッドを呼び出す必要はありません。 これは、電話オブジェクトの実装が電話を開き、TAPI 初期化中または新しい電話オブジェクトが表示されたときに phoneGetID を呼び出すことができるためです。

TAPI は、ITPhone::EnumeratePreferredAddresses によって返される IEnumAddress インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、IEnumAddress インターフェイスで Release を呼び出して、関連付けられているリソースを解放する必要があります。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi3if.h (Tapi3.h を含む)
Library Uuid.lib
[DLL] Tapi3.dll

こちらもご覧ください

EnumerateAddresses

IEnumAddress

ITPhone

phoneGetID