phoneGetIcon 関数 (tapi.h)
phoneGetIcon 関数を使用すると、アプリケーションは、ユーザーに表示できるサービス電話デバイス固有の (またはプロバイダー固有の) アイコンを取得できます。
構文
LONG phoneGetIcon(
DWORD dwDeviceID,
LPCSTR lpszDeviceClass,
LPHICON lphIcon
);
パラメーター
dwDeviceID
アイコンが要求された電話デバイスの識別子。
lpszDeviceClass
デバイス クラス名を識別する null で終わる文字列へのポインター。 このデバイス クラスを使用すると、アプリケーションは、そのデバイス クラスに適用できる特定のサブアイコンを選択できます。 このパラメーターは省略可能であり、 NULL または空のままにすることができます。この場合、指定されたメディア ストリーム デバイスではなく、電話デバイスに関連付けられている最上位のアイコンが選択されます。
lphIcon
アイコンへのハンドルが返されるメモリ位置へのポインター。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_BADDEVICEID、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_OPERATIONFAILED、PHONEERR_INVALDEVICECLASS、PHONEERR_UNINITIALIZED、PHONEERR_NOMEM、PHONEERR_NODEVICE。
注釈
phoneGetIcon 関数を使用すると、プロバイダーは、指定された電話に関連付けられているアイコン リソース (LoadIcon から取得) にハンドル (lphIcon 内) を返します。 アイコン ハンドルは、プロバイダーに関連付けられているリソース用です。プロバイダーがアンロードされた後にアイコンを参照する場合は、アプリケーションで CopyIcon を使用する必要があります。これは、アプリケーションが電話を開いている限り発生する可能性は低いです。
lpszDeviceClass パラメーターを使用すると、プロバイダーは、呼び出し元によって参照されているサービスの種類に基づいて異なるアイコンを返すことができます。 許可される文字列は、 phoneGetID の場合と同じです。 たとえば、電話で Comm API がサポートされている場合、 lpszDeviceClass として "COMM" を渡すと、プロバイダーはサービス プロバイダーの Comm デバイス機能に関連するアイコンを返します。 パラメーター "tapi/phone"、""、または NULL を 使用して、電話サービスのアイコンを要求できます。
2.0 より前の TAPI バージョンを使用しているアプリケーションの場合、プロバイダーがアイコンを返さない場合 (指定されたデバイス クラスが無効であるか、プロバイダーがアイコンをサポートしていないかどうかに関係なく)、TAPI は汎用テレフォニー電話デバイス アイコンを置き換えます。 TAPI バージョン 2.0 以降を使用するアプリケーションの場合、 lpszDeviceClass パラメーターが "tapi/phone"、""、または NULL の場合にのみ、TAPI は既定の電話アイコンを置き換えます。 その他のデバイス クラスの場合、指定されたデバイス クラスが無効な場合、またはプロバイダーがクラスのアイコンをサポートしていない場合、 phoneGetIcon はPHONEERR_INVALDEVICECLASSを返します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |