次の方法で共有

ITAddress2::get_PreferredPhones メソッド (tapi3if.h)

  • [アーティクル]

get_PreferredPhones メソッドは、このアドレスで使用する電話デバイスに対応する電話オブジェクトのコレクションを返します。

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

構文

HRESULT get_PreferredPhones(
  [out] VARIANT *pPhones
);

パラメーター

[out] pPhones

ITPhone インターフェイス ポインターの ITCollection を含む VARIANT へのポインター。

戻り値

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

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

注釈

電話デバイスは、デバイス クラス tapi/line で phoneGetID を使用してアドレス/回線 ID を返すことによって、アドレスまたはアドレスのセットに優先されると宣言します。 このアドレスで使用できる電話がない場合、 メソッドは空のコレクションを生成し、S_OKを返します。

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

要件

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

こちらもご覧ください

ITAddress2

ITPhone