次の方法で共有


ITLegacyAddressMediaControl::GetID メソッド (tapi3if.h)

GetID メソッドは、現在のアドレスに関連付けられている指定されたデバイス クラスのデバイス識別子を返します。

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

構文

HRESULT GetID(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceID
);

パラメーター

[in] pDeviceClass

構成情報が必要な TAPI デバイス クラスを含む BSTR へのポインター。

[out] pdwSize

返されるデバイス識別子の長さ。

[out] ppDeviceID

デバイス識別子。

戻り値

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

リターン コード 説明
S_OK
メソッドが成功しました。
E_FAIL
メソッドが失敗しました。 これは、現在のアドレスに関連付けられている指定されたクラスのデバイスがないことを意味する可能性があります。
E_POINTER
pdwSize パラメーターまたは ppDeviceID パラメーターが有効なポインターではありません。

注釈

このメソッドを呼び出す前に、アプリケーションで ITTAPI::RegisterCallNotifications を呼び出す必要があります。

アプリケーションでは 、SysAllocString を使用して pDeviceClass パラメーターのメモリを割り当て、 SysFreeString を使用して変数が不要になったときにメモリを解放する必要があります。

アプリケーションで CoTaskMemFree 関数を呼び出して、 ppDeviceID パラメーターに割り当てられたメモリを解放する必要があります。

TAPI 2.1 相互参照: lineGetDevConfiglineSetDevConfiglineGetID

要件

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

こちらもご覧ください

GetDevConfig

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig