ITTAPI::EnumerateAddresses メソッド (tapi3if.h)

[アーティクル]
03/02/2024

EnumerateAddresses メソッドは、現在使用できるアドレスを列挙します。 C および C++ アプリケーション用に提供されます。 Visual Basic で記述されたものなどのオートメーションクライアントアプリケーションでは、 get_Addresses メソッドを使用する必要があります。

構文

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

パラメーター

[out] ppEnumAddress

IEnumAddress インターフェイスへのポインター。

戻り値

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

値	意味
S_OK	メソッドが成功しました。
E_POINTER	ppEnumAddress パラメーターが有効なポインターではありません。
E_INVALIDARG	TAPI オブジェクトが初期化されていません。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。

注釈

アプリケーションでは通常、この列挙体を使用して各アドレスの機能をチェックし、現在の目的に役立つものを決定します。

予想されるアドレスが見つからない場合は、適切なサービスプロバイダーがインストールされていないか、正しく動作していない可能性があります。

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

TAPI セッション中にアドレスが作成または削除された場合、アプリケーションは ITTAPIEventNotification インターフェイスを介して通知されます。プラグアンドプレイデバイスをインストールするなどしてアドレスが作成された場合、ITTAPIEventNotification::Event は、TAPIOBJECT_EVENT列挙型のTE_ADDRESSCREATE メンバーを返します。アドレスが削除された場合、ITTAPIEventNotification::Event はTE_ADDRESSREMOVEを返します。これらのイベントの後 に EnumerateAddresses を呼び出すと、現在のアドレスが反映されます。