英語で読む

次の方法で共有


コールバック関数を構成する

Configure 関数は、エキスパート DLL 内でエキスパートを構成します。

エキスパートは Configure 関数を実装する必要があります。 関数呼び出しを受け取ると、エキスパートはダイアログ ボックスを表示し、ユーザーが構成可能な項目を変更できるようにします。

構文

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

パラメーター

hExpertKey [in]

一意のエキスパート識別子。

一意識別子は、すべてのエキスパート固有のネットワーク モニター関数に返されます。 識別子は 、Run 関数に渡されたものと同じエキスパート キーではない可能性があることに注意してください。 [呼び出しの 構成] からエキスパート キーを保存しないでください。

ppConfig [in, out]

エントリ時に EXPERTCONFIG 構造体へのポインターへのポインター。

正常に終了すると、参照先の EXPERTCONFIG 構造体に新しい構成データが含まれます。

pExpertStartupInfo [in]

エキスパートの開始時にフォーカスがあるキャプチャ要素へのポインター。

StartupFlags [in]

エキスパートが pExpertStartupInfo パラメーターを使用する方法を示すフラグ。 定義されているフラグは EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATAのみです。 フラグは、渡された ppConfig パラメーターではなく、エキスパートが pExpertStartupInfo パラメーターを使用することを示します。 通常は、コンテキスト メニューからエキスパートを起動するときにフラグを設定します。

hWnd [in]

親ウィンドウへのハンドル。 ハンドルを使用してダイアログ ボックスを開きます。

戻り値

関数が成功した場合 (つまり、現在の構成が存在する場合)、戻り値は TRUE です

関数が失敗した場合、戻り値は FALSE になります

解説

Network Monitor は、エキスパートの現在の構成を使用して Configure 関数を呼び出します (存在する場合)。 エキスパートがダイアログ ボックスを表示し、構成可能な項目を変更できます。

ppConfig が渡され、ネットワーク モニターに指定されたエキスパートの構成が格納されていない場合、パラメーター値は NULL にすることができます。 この場合、 Configure 関数は、ハードコーディングされた既定値 (またはスタートアップ情報を使用) を想定してダイアログ ボックスを開きます。

構成データは、Configure 関数が戻るときに NULL にすることもでき、NULL が渡されました。 この状況は、ネットワーク モニターに既定値が格納されておらず、ユーザーが [キャンセル] を押したときに発生します。

EXPERTCONFIG データ構造の先頭には、構造体のサイズ情報を格納する Private セクションが含まれています。 EXPERTCONFIG 構造体のサイズには、構造体の先頭に表示される予約済みの DWORD 長さを含める必要があります。 たとえば、構成データに 20 バイトのストレージ領域が必要な場合は、データを格納するために 24 バイトを割り当てます。 ppConfigNULL の場合、Configure 関数は ExpertAllocMemory 関数を呼び出して、正しいサイズの新しい構成を割り当てます。 バッファーがエキスパート データを保持するのに十分でない場合、エキスパートは ExpertReallocMemory 関数を呼び出す必要があります。

要件

要件
サポートされている最小のクライアント
Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Netmon.h