Win32 API 日本語リファレンス
ホーム › Devices.Tapi › TUISPIDLLCALLBACK

TUISPIDLLCALLBACK

コールバック

シグネチャ

INT TUISPIDLLCALLBACK(
    UINT_PTR dwObjectID,
    DWORD dwObjectType,
    void* lpParams,
    DWORD dwSize
);

パラメーター

フィールド型説明
dwObjectIDUINT_PTRdwObjectType で指定された型のオブジェクト識別子です。
dwObjectTypeDWORD

TUISPIDLL_OBJECT_ 定数のいずれかで、dwObjectID で識別されるオブジェクトの型を指定します

TUISPIDLL_OBJECT_LINEID

dwObjectID パラメーターは回線デバイス識別子 (dwDeviceID) です。これは、 TUISPI_lineConfigDialog または TUISPI_lineConfigDialogEdit の処理中にコールバックが呼び出される場合に使用されます。

TUISPIDLL_OBJECT_PHONEID

dwObjectID パラメーターは電話デバイス識別子 (dwDeviceID) です。これは、 TUISPI_phoneConfigDialog の処理中にコールバックが呼び出される場合に使用されます。

TUISPIDLL_OBJECT_PROVIDERID

dwObjectID パラメーターは永続的なプロバイダー識別子です。これは、 TUISPI_providerConfig、 TUISPI_providerInstall、または TUISPI_providerRemove の処理中にコールバックが呼び出される場合に使用されます。

TUISPIDLL_OBJECT_DIALOGINSTANCE

dwObjectID パラメーターは HDRVDIALOGINSTANCE で、サービスプロバイダーが LINE_CREATEDIALOGINSTANCE メッセージを送信したときに返されたものです。これは、 TUISPI_providerGenericDialog の処理中にコールバックが呼び出される場合に使用されます。

lpParamsvoid*パラメーターブロックを保持するために使用されるメモリ領域へのポインターです。
dwSizeDWORD

パラメーターブロックのサイズ (バイト単位)。

メモ 構造体のサイズパラメーターが正しくない場合、データが上書きされる可能性があります。構造体のサイズ設定の詳細については、 メモリ割り当て のトピックを参照してください。

公式ドキュメント

DllCallbackProc 関数は、UI DLL がサービスプロバイダーにプライベートなパラメーターブロックを送信するために呼び出されます。このコールバックを呼び出すたびに、指定されたオブジェクトに関連付けられたサービスプロバイダーの TSPI_providerGenericDialogData 関数が呼び出されます。パラメーターブロックの内容は、サービスプロバイダーと UI DLL によって定義されます。サービスプロバイダーはパラメーターブロックの内容を変更できます。この関数から制御が戻ると、TAPI は変更されたデータを元の UI DLL のパラメーターブロックへコピーして戻します。

TUISPIDLLCALLBACK 型は、このコールバック関数へのポインターを定義します。DllCallbackProc は、アプリケーション定義の関数名のプレースホルダーです。

戻り値

成功した場合は 0 を返します。失敗した場合は、次のいずれかの負のエラー値を返します。

LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)