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
デバイス識別子。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
メソッドが失敗しました。 これは、現在のアドレスに関連付けられている指定されたクラスのデバイスがないことを意味する可能性があります。 |
|
pdwSize パラメーターまたは ppDeviceID パラメーターが有効なポインターではありません。 |
注釈
このメソッドを呼び出す前に、アプリケーションで ITTAPI::RegisterCallNotifications を呼び出す必要があります。
アプリケーションでは 、SysAllocString を使用して pDeviceClass パラメーターのメモリを割り当て、 SysFreeString を使用して変数が不要になったときにメモリを解放する必要があります。
アプリケーションで CoTaskMemFree 関数を呼び出して、 ppDeviceID パラメーターに割り当てられたメモリを解放する必要があります。
TAPI 2.1 相互参照: lineGetDevConfig、 lineSetDevConfig、 lineGetID
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi3if.h (Tapi3.h を含む) |
Library | Uuid.lib |
[DLL] | Tapi3.dll |