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

GetID メソッドは、現在の呼び出しに関連付けられているデバイスの識別子を取得します。

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

構文

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

[in] pDeviceClass

TAPI デバイスクラスを表す BSTR へのポインター。

[out] pdwSize

デバイス識別子のサイズ (バイト単位)。

[out] ppDeviceID

デバイス識別子。

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
E_POINTER	pdwSize パラメーターまたは ppDeviceID パラメーターが有効なポインターではありません。

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

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

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